@viberaven/cli

VibeRaven is the Agent Context + Production Gate for AI-built apps. It gives Claude Code, Codex, Cursor, and other coding agents a production-readiness loop before Vercel/Supabase deployment.

Humans

npx -y viberaven

No subcommand is needed in a real terminal. It opens the interactive menu for sign-in, scan, report, provider guides, dashboards, prompts, and sign-out.

Coding Agents

Agents should run:

npx -y viberaven --agent-mode

If running from the viberaven monorepo root, run:

node packages/cli/dist/cli.js --agent-mode

Then read artifacts in this order:

1. .viberaven/agent-tasklist.md
2. .viberaven/gate-result.json
3. .viberaven/context-map.json
4. .viberaven/agent-summary.md
5. .viberaven/launch-playbook.md

Fix one repo-code gap, then run:

npx -y viberaven --verify
npx -y viberaven --strict

For focused work:

npx -y viberaven next --json
npx -y viberaven prompt --gap <id>
npx -y viberaven audit --vercel-supabase

Provider dashboard checks are not cleared by repo-code edits. Billing/product configuration, DNS, webhooks, credentials, quotas, and live provider verification must be completed or verified in the provider dashboard or through read-only provider evidence.

Production Copilot Loop

VibeRaven runs a batch-disciplined loop until the production gate clears. Do not stop at "scan complete."

1. Scan — Run --agent-mode. Read .viberaven/agent-tasklist.md and parse VIBERAVEN_NEXT_ACTION from stdout for batchSize, batchApplied, scanNow, and stalled.
2. Batch heals — For each repo-code task where requiresUserAction: false, apply up to batchSize heals per batch (free=3, pro=10) via viberaven_heal_apply { gap: "<gapId>", yes: true } or --heal --apply --gap <id> --yes. When scanNow: true, verify before applying more heals.
3. Verify and clear — Run --verify once per batch (not after every heal). Repeat until gate.status === 'clear' in .viberaven/gate-result.json. For provider gaps, read VIBERAVEN_PROVIDER_ACTION, complete the dashboard step, then verify.

If stalled: true, stop calling verify and address provider-action gaps or report to the user. Run --strict before deploy or CI pass.

Machine Output

npx -y viberaven --agent-mode --json
npx -y viberaven --agent-mode --jsonl
npx -y viberaven --strict --json

Machine artifact contract:

docs/contracts/artifacts.md
https://viberaven.dev/schemas/gate-result.schema.json
https://viberaven.dev/schemas/context-map.schema.json
https://viberaven.dev/schemas/gap.schema.json
https://viberaven.dev/schemas/heal-result.schema.json

Development

npm run cli:build
npm run cli:test
node packages/cli/dist/cli.js scan