CLI Reference

This page lists the main VibePro command groups. Run vibepro help for the full generated command list for your installed version.

Basic commands

vibepro help [command] [--language ja|en]
vibepro version
vibepro --version
vibepro doctor [repo] [--fix] [--json]
vibepro status [repo] [--json]
vibepro usage report [repo] [--since <date>] [--subagent-roi] [--language ja|en] [--json]

Setup and configuration

vibepro init [repo] [--story-id <id> --title <title>] [--language ja|en]
vibepro config language [repo] --language ja|en
vibepro skills list [--json]
vibepro skills install [repo] [--dry-run] [--force] [--json]
vibepro skills verify [repo] [--json]
vibepro codex install [repo] [--dry-run] [--force] [--json]
vibepro codex verify [repo] [--json]

Diagnosis and checks

vibepro check <ui|security|performance|architecture|pr-readiness|launch-readiness|agent-harness|public-discovery|self-dogfood|oss-readiness|regression-risk|all> [repo] [--run-id <id>] [--story-id <id>] [--base <ref>] [--head <ref>] [--measure] [--include-harness] [--include-public-discovery] [--fail-on-findings] [--json]
vibepro diagnose [repo] [--run-id <id>]
vibepro graph [repo] [--from <graphify-out>] [--run-graphify]
vibepro env graph [repo] [--json] [--no-write]

Story, spec, and traceability

vibepro story list [repo] [--all]
vibepro story add [repo] --id <id> --title <title>
vibepro story select [repo] --id <id>
vibepro story archive [repo] --id <id>
vibepro story runs [repo] [--id <id>]
vibepro story status [repo] [--id <id>]
vibepro story report [repo] [--id <id>]
vibepro story diagnose [repo] --id <id> [--run-graphify]
vibepro story derive [repo] [--run-graphify] [--json]
vibepro story map [repo] [--json]
vibepro story plan [repo] [--limit <n>] [--json]
vibepro spec fingerprint [repo] --id <story-id> [--include-instructions] [--json]
vibepro spec write [repo] --id <story-id> [--from-stdin] [--input <file>] [--json]
vibepro spec show [repo] --id <story-id> [--clause <clause-id>] [--json]
vibepro spec drift [repo] --id <story-id> [--against <git-ref>] [--json]
vibepro trace backfill [repo] [--story-id <id>] [--dry-run] [--json]
vibepro trace declare [repo] --story-id <id> --lifecycle declared_not_started|unknown [--reason <text>] [--json]
vibepro report fingerprint [repo] --kind <kind> --id <story-id> [--base <ref>] [--task <id>] [--group <id>] [--include-instructions]
vibepro report write [repo] --kind <kind> --id <story-id> [--from-stdin] [--input <file>] [--caller <name>]
vibepro report show [repo] --kind <kind> --id <story-id>

Verification and decisions

vibepro verify flow [repo] --base-url <url> [--id <story-id>] [--headed] [--json]
vibepro verify record [repo] --id <story-id> --kind <unit|integration|e2e|typecheck|build> --status <pass|fail|needs_setup> --command <cmd> [--json]
vibepro verify import-ci [repo] --id <story-id> [--pr <number>] [--check <name>=<kind>]... [--json]
vibepro decision record [repo] --id <story-id> --type <needs_review|noise|waiver|secret_exposure> --summary <text> [--source <gate-or-finding-id>] [--json]
vibepro decision status [repo] --id <story-id> [--json]

Agent Review

vibepro review prepare [repo] --id <story-id> --stage <stage> [--role <role>] [--json]
vibepro review repair [repo] [--story-id <id>] [--dry-run] [--json]
vibepro review start [repo] --id <story-id> --stage <stage> --role <role> --agent-system codex|claude_code --agent-id <id> [--json]
vibepro review close [repo] --id <story-id> --stage <stage> --role <role> --agent-id <id> [--json]
vibepro review record [repo] --id <story-id> --stage <stage> --role <role> --status <pass|needs_changes|block> --summary <text> [--json]
vibepro review status [repo] --id <story-id> [--stage <stage>] [--all] [--history] [--json]

Checkpoints, execution, and tasks

vibepro checkpoint <story|implementation-start|test-plan|implementation-complete|verification|pr> [repo] [--story-id <id>] [--base <ref>] [--head <ref>] [--task <task-id>] [--group <group-id>] [--json]
vibepro execute <start|status|next|reconcile|merge> [repo] --story-id <id>|--all-merged [--json]
vibepro task create [repo] --from-plan [--id <story-id>] [--task <task-id>] [--limit <n>] [--json]
vibepro task list [repo] [--id <story-id>]
vibepro task show [repo] --task <task-id> [--id <story-id>]
vibepro task brief [repo] --task <task-id> [--group <group-id>] [--id <story-id>]
vibepro task plan [repo] --task <task-id> [--group <group-id>] [--id <story-id>]
vibepro task handoff [repo] --task <task-id> [--group <group-id>] [--id <story-id>]
vibepro task execute [repo] --task <task-id> [--group <group-id>] [--id <story-id>] [--base <ref>] [--dry-run-pr] [--json]

PR workflow

vibepro pr prepare [repo] [--story-id <id>] [--task <task-id>] [--group <group-id>] [--base <ref>] [--head <ref>] [--evidence-depth summary|standard|full] [--json]
vibepro pr ship [repo] [--story-id <id>] [--task <task-id>] [--group <group-id>] [--base <ref>] [--head <branch>] [--dry-run] [--json]
vibepro pr create [repo] [--story-id <id>] [--task <task-id>] [--group <group-id>] [--base <ref>] [--head <branch>] [--dry-run] [--json]

Exploration, journey, and harness

vibepro explore prepare [repo] --id <story-id> [--topic <text>] [--role <role>] [--json]
vibepro explore record [repo] --id <story-id> --role <role> --status <pass|needs_review|block> --summary <text> [--json]
vibepro explore status [repo] --id <story-id> [--json]
vibepro journey derive [repo] [--id <journey-id>] [--json]
vibepro journey map [repo] [--json]
vibepro journey status [repo] [--json]
vibepro harness status [repo] [--json]
vibepro harness map [repo] [--json]
vibepro harness learn [repo] --summary <text> [--kind <kind>] [--source <source>] [--evidence <ref>] [--pattern <text>] [--skill-candidate <text>] [--target <surface>] [--json]
vibepro harness review-learnings [repo] [--json]

Design System and modernization

vibepro design-system init [repo] --id <ds-id> --product <name> [--json]
vibepro design-system derive [repo] --id <ds-id> [--product <name>] [--routes <csv>] [--brief <text>] [--from-code] [--json]
vibepro design-system ingest [repo] --id <ds-id> --bundle <file> [--product <name>] [--json]
vibepro design-system ingest-brief [repo] --id <ds-id> --brief-file <path> [--json]
vibepro design-system ingest-design-md [repo] --id <ds-id> --file <file> [--product <name>] [--json]
vibepro design-system export [repo] --id <ds-id> --format json|markdown|css|design-md [--json]
vibepro design-system export-design-md [repo] --id <ds-id> [--json]
vibepro design-system lint [repo] --id <ds-id> [--file <file>] [--json]
vibepro design-system diff [repo] --id <ds-id> --base <base-ref> [--json]
vibepro design-system validate [repo] --id <ds-id> --story-id <story-id> [--json]
vibepro design-modernize derive-system [repo] --id <story-id> [--product <name>] [--routes <csv>] [--brief <text>] [--json]
vibepro design-modernize plan [repo] --id <story-id> [--product <name>] [--routes <csv>] [--json]
vibepro design-modernize capture [repo] --id <story-id> --base-url <url> [--route <path>] [--routes <csv>] [--json]

Performance

vibepro measure [repo] [--base-url <url>] [--pages <csv>] [--apis <csv>] [--samples <n>] [--json]
vibepro performance define [repo] --id <story-id> --metric-id <id> --user-story <text> --start-condition <text> --completion-condition <text> [--json]
vibepro performance record [repo] --id <story-id> --metric-id <id> --label <before|after> --status <completed|blocked|needs_review|timeout|auth_required|resource_unavailable|unknown> [--json]
vibepro performance compare [repo] --id <story-id> [--metric-id <id>] [--json]
vibepro measure compare [repo] --before <performance.json> --after <performance.json> [--json]

Publication and ecosystem

vibepro brainbase [repo] [--sync-stories] [--publish-status] [--dry-run] [--story-id <id>]