Cloud commands

Upload runs and baselines to a Dungbeetle cloud server. Both commands take their own connection flags (--server / --client-id / --client-secret) or the DUNGBEETLE_SERVER_URL / DUNGBEETLE_CLIENT_ID / DUNGBEETLE_CLIENT_SECRET environment variables. See the Cloud server guide.

push

Uploads a JSON run report (selected with --report <path>) to a cloud server. --branch <name> and --commit <sha> label the run in the history and review timeline.

push-baselines

Uploads local baselines to a cloud server, versioned per (project, target). A new version is created only when the content digest changes. --target <name...> scopes the upload.

anon

Captures a target and shares it on a cloud server without an account — the link is public, read-only, and deleted after 24 hours.

# Share a one-off snapshot of a page
dungbeetle anon https://example.com --server https://dungbeetle.dev

# Compare two pages and share the semantic diff + screenshots (the good demo)
dungbeetle anon https://dungbeetle.dev/demo \
  --compare "https://dungbeetle.dev/demo?v=2" --screenshot --server https://dungbeetle.dev

# Or capture a command's output instead of a URL
dungbeetle anon --cmd "my-cli --version" --server https://dungbeetle.dev

With --compare the first URL is captured as the baseline and the second as the candidate; the shared page leads with the node-level semantic diff — exactly what test reports in CI. --screenshot adds full-page screenshots (via a local Chrome/Chromium; the trial degrades gracefully without one), so the shared page also gets the side-by-side / onion-skin visual comparison. --name labels the capture; --server falls back to DUNGBEETLE_SERVER_URL.