Back to docs

Occhio Cloud

Hosted PR review pipeline for flow captures, issue storage, and GitHub PR comments.

What Cloud adds

Hosted analysis: accessibility + (plan-gated) Nielsen and friction layers.

Run history: run, flow_result, and issue records persisted in Supabase.

PR commenting: updates or creates Occhio comment on pull requests through GitHub API.

Plan requirements

Hosted PR reviews are billed and plan-gated:

Free: 0 hosted PR reviews/month (Local CLI only)

Pro ($39/mo): 300 hosted PR reviews/month, crawler + flow detection, Nielsen + friction

Enterprise: unlimited hosted PR reviews

Cloud setup path

  1. Connect repository in /dashboard/connect.
  2. Run quick setup to commit `.occhio/config.yaml` and `.github/workflows/occhio.yml`.
  3. Create/edit flows in dashboard.
  4. Generate an OCCHIO_TOKEN in Settings and store it as GitHub secret.
  5. Send flow payloads to POST /api/v1/analyze from CI.

The default quick-setup workflow currently runs local occhio scan. Hosted flow ingestion is done via the Analyze API contract.

Flow detection wizard (Pro)

Wizard route: /dashboard/[repo]/setup. Stages include URL input, crawling, optional auth-session retry, flow review, test-data overrides, and save/export.

Crawl jobs expose statuses pending, crawling, detecting,completed, and failed via /api/crawl/:jobId.

Required integrations

  • Supabase auth + database migrations
  • GitHub App (webhook + installation support)
  • Stripe (billing and plan upgrades)
  • Trigger.dev + Playwright (background crawling)
  • Anthropic API key (flow detection + Nielsen analysis)