CLI Reference

VisionSpec provides a command-line interface for managing specifications.

Global Flags

Flag	Short	Description
--project	-p	Project name or path
--verbose	-v	Enable verbose output
--help	-h	Show help
--version		Show version

Commands

Project Setup

Command	Description
init	Initialize a new project
create	Create specs from templates
lint	Validate directory structure
status	Show project status
profiles	Manage configuration profiles

Spec Workflow

Command	Description
eval	Evaluate specs using LLM judges
render	Render evaluation files to markdown
synthesize	Generate GTM/technical specs from sources
reconcile	Generate unified execution spec
approve	Approve a spec for reconciliation
watch	Watch spec files and auto-run eval
version	Manage spec version history

Export & Integration

Command	Description
export	Export to target execution system
targets	List available export targets
serve	Start MCP server
docs	Generate MkDocs documentation
rules	Manage workflow rules for AI assistants

Execution Integration

Command	Description
align	Check spec-to-reality alignment
drift	Detect spec-to-code drift
generate	Generate test stubs from TPD
sync	Sync status with execution targets
metrics	View evaluation metrics dashboard
hooks	Manage Git hooks (install, uninstall, status)

Context & Traceability

Command	Description
context	Gather codebase context
graph	Manage requirement graphs

Usage Examples

# Initialize a project
visionspec init user-onboarding

# Lint all projects
visionspec lint

# Lint specific project
visionspec lint user-onboarding

# Check status
visionspec status -p user-onboarding

# JSON output
visionspec status -p user-onboarding --format json

# Generate HTML report
visionspec status -p user-onboarding --format html > status.html

# CI mode (exit non-zero if not ready)
visionspec status -p user-onboarding --ci

# List export targets
visionspec targets