CLI Reference

SpecOps provides a unified command-line interface (spec-ops).

Subcommands

Command	Arguments	Description
`spec-ops init`	`[--dir PATH] [--name NAME] [--profile PROFILES] [--agent AGENTS] [--diataxis/--no-diataxis] [--github-pages/--no-github-pages] [--pre-commit/--no-pre-commit]`	Bootstrap a new PMaC project with profile ADRs and multi-agent platform adapters
`spec-ops adopt`	`[--name NAME] [--dir DIR] [--profile PROFILES] [--grandfather-debt] [--no-grandfather-debt]`	Adopt SpecOps into an existing brownfield codebase with debt baseline
`spec-ops profiles list`	None	List available architectural profiles
`spec-ops profiles apply`		Apply architectural profile to current repository
`spec-ops profiles sync`		Synchronize or restore architectural profile artifacts
`spec-ops profiles info`	`[--json]`	Inspect active architectural profile rules and quality preflight commands
`spec-ops profiles package`	`[--out OUT] [--output OUT]`	Package custom profile into distributable bundle (.sop / .tar.gz)
`spec-ops profiles export`	`[--out OUT] [--output OUT]`	Package custom profile into distributable bundle (.sop / .tar.gz)
`spec-ops profiles install`		Install custom profile bundle into repository
`spec-ops profiles validate`		Validate profile manifest and resolve inheritance DAG
`spec-ops profiles inspect`	`[TARGET]`	Inspect resolved profile inheritance, merged ADRs and invariant constraints
`spec-ops scaffold agents`	None	Regenerate AGENTS.md constitution from installed profiles
`spec-ops health`	`[--security] [--architecture] [--suggest-splits] [--emit-task] [--generate-refactor-tasks] [--check-uat] [--json]`	Verify file length limits, architecture boundaries, and security profile guardrails
`spec-ops decompose`	`[--suggest PATH] [PATH]`	Analyze AST seams and recommend modular file decomposition
`spec-ops stats`	`[--cache] [--persona-coverage]`	Report project statistics, persona coverage distribution, and entity counts
`spec-ops parse`	`PATH`	Parse specification file with resilient AST diagnostics
`spec-ops graph compile`	`[--incremental] [--json] [--force-cold]`	Compile repository relational knowledge graph backed by content-addressed cache
`spec-ops prd create`	`[--title TITLE] [--persona PERSONA] [--component COMPONENT] [--summary SUMMARY] [--stage STAGE]`	Scaffold a new PRD specification
`spec-ops prd new`	`[--title TITLE] [--persona PERSONA] [--component COMPONENT] [--friction FRICTION] [--good GOOD] [--anti-goals ANTI_GOALS] [--outcomes OUTCOMES] [--non-interactive]`	Interactively scaffold a new PRD specification in idea stage
`spec-ops prd lint`	`[PATH]`	Lint PRD markdown files for mandatory sections and falsifiable outcomes
`spec-ops prd promote`	`--stage STAGE`	Advance PRD through lifecycle stage gates
`spec-ops prd ship`		Transition accepted PRD to shipped upon backlog completion
`spec-ops prd audit`	`[PRD_ID] [--deep]`	Audit PRD decomposition readiness and continuous checkable outcome coverage
`spec-ops prd decompose`	`[--no-spike] [--by-outcomes] [--diff]`	Decompose PRD into vertical slices
`spec-ops prd studio`	`[--open] [--port PORT] [--host HOST]`	Run interactive Web PRD Studio and Low-Code Story Assistant
`spec-ops curate`	`[ACTION] [--infer] [--dry-run] [--model MODEL] [--json]`	Perform JIT backlog refinement, cognitive drift reconciliation, and scope slicing
`spec-ops visualizer`	`[--serve] [--build OUT] [--port PORT]`	Interactive 2D graph visualizer
`spec-ops visualizer export`	`[--output OUT]`	Export standalone single-file HTML visualizer bundle
`spec-ops worker`	`[ACTION] [TASK_ID] [--task TASK_ID] [--auto] [--drain] [--max-concurrency N] [--max-tasks M] [--dry-run] [--no-merge] [--no-review] [--skip-review]`	Execute backlog task in isolated worktree with concurrent review
`spec-ops cycle`	`[--max-tasks N] [--max-concurrency N] [--drain] [--dry-run] [--no-merge] [--build-docs] [--no-review] [--skip-review]`	Run end-to-end autonomous development cycle
`spec-ops rescue`	`[TASK_ID] [--list] [--complete] [--discard] [--prune]`	Inspect and recover stalled or failed autonomous worktrees
`spec-ops spike create`	`--name NAME --question QUESTION [--timebox TIMEBOX] [--task TASK_ID] [--prd PRD_ID]`	Author a new architectural spike task and isolated test harness
`spec-ops spike start`	`[--hypothesis HYPOTHESIS] [--timebox TIMEBOX]`	Instantiate disposable sandboxed spike worktree
`spec-ops spike check`	`[SPIKE_ID] [--elapsed ELAPSED]`	Check spike timebox and write isolation
`spec-ops spike preflight`	`[SPIKE_ID]`	Enforce in-worktree write isolation preflight hook
`spec-ops spike graduate`	`--result {proven,disproven} [--title TITLE] [--notes NOTES] [--findings FINDINGS] [--status STATUS]`	Graduate empirical spike findings into an Architectural Decision Record
`spec-ops tui`	`[--once] [--view {overview,backlog,tree,health}]`	Launch interactive Terminal UI (TUI) dashboard
`spec-ops queue next`	`[--json]`	Inspect next ready, unblocked backlog task
`spec-ops queue complete`	`[--base BASE]`	Gate and complete task integration under merge lock
`spec-ops queue tree`	`[--task TASK] [--direction {blocks,blocked-by}] [--reverse] [--waves] [--all] [--json]`	Display task dependency tree, execution waves, and blockers
`spec-ops queue block`	`--question QUESTION [--type {unknown,spike_needed,external,dependency}] [--spike] [--timebox TIMEBOX] [--raised-by RAISED_BY]`	Mark a task as blocked by an unknown question or impediment
`spec-ops queue unblock`	`--resolution RESOLUTION [--adr ADR]`	Resolve an unknown/blocker and restore ready/proposed state
`spec-ops queue blockers`	`[--json]`	List all currently blocked tasks, open questions, and linked spikes
`spec-ops queue monitor`	`[--once]`	Interactive terminal backlog flow monitor and JIT buffer telemetry
`spec-ops backlog flow`	`[--once]`	Interactive terminal backlog flow monitor and JIT buffer telemetry
`spec-ops report burndown`	`[--milestone MILESTONE] [--format {deck,html,digest}] [-o OUTPUT] [--output OUTPUT] [--check-alignment]`	Milestone burndown velocity and presentation slide deck export
`spec-ops report milestone`	`[--milestone MILESTONE] [--format {digest,deck,html}] [-o OUTPUT] [--output OUTPUT] [--check-alignment]`	Milestone executive briefing digest and scope alignment
`spec-ops security verify-lock`	`[--path PATH]`	Verify supply-chain lockfile cryptographic hashes and pinning
`spec-ops audit dependencies`	`[--path PATH] [--offline]`	Scan direct and transitive dependencies for High/Critical CVEs and enforce license allowlists
`spec-ops audit export`	`[--standard STANDARD] [--output OUTPUT]`	Compile and export tamper-evident Merkle compliance audit manifest
`spec-ops audit verify`	`[--manifest MANIFEST] [--repo REPO]`	Verify cryptographic compliance manifest integrity and SDLC traceability
`spec-ops review`	`[TASK_ID] [--identity IDENTITY] [--provenance]`	Generate structured architectural review brief or cryptographically sign review
`spec-ops docs build`	`[--out OUT_DIR] [--base-url BASE_URL] [--include-visualizer]`	Compile Diataxis documentation static site and embedded 2D visualizer
`spec-ops docs audit`	`[--dir DIR] [--strict]`	Audit Diataxis quadrant structure, CLI drift, and documentation code snippets