Harness commands

Voss uses one binary with three command families:

Harness commands for single-agent natural-language work
Compiler commands for .voss programs
Orchestration commands for team runs — see Orchestration and the CLI reference

Command	Purpose	Default mode
`voss`	Start the interactive harness REPL	`plan`
`voss chat`	Explicit REPL command	`plan`
`voss do "<task>"`	Run one task and exit	`plan`
`voss edit <path>`	Start a scoped edit session	`edit`
`voss recall <query>`	Search code and project memory together	n/a
`voss sync`	Generate or update project workflow docs and managed instruction sections	n/a
`voss doctor`	Diagnose provider, config, compiler, and tool setup	n/a
`voss tools`	List tool registry entries and mutability	n/a
`voss config`	Open or show harness configuration	n/a
`voss sessions`	List saved sessions	n/a
`voss resume <id>`	Resume a prior session by id prefix or name	session mode

Compiler commands

Command	Purpose
`voss check <path>`	Check `.voss` files without running them
`voss compile <file.voss>`	Emit readable Python
`voss run <file.voss>`	Compile and execute a `.voss` program
`voss init <name>`	Scaffold a Voss project
`voss ast <file.voss>`	Print parser output for debugging

voss run is not an agent command. Natural-language tasks use voss do.

Orchestration commands

For multi-agent team runs — full detail in Orchestration.

Command	Purpose
`voss team check`	Validate the team cage (roster, scope, budget, tools)
`voss team run "<goal>"`	Run a goal as a reviewed team
`voss board`	Render the board read-only from persisted nodes
`voss review`	Show per-card Reviewer-A + Reviewer-B verdicts
`voss session tree <root_id>`	Inspect per-agent budget, scope, and status
`voss capabilities list`	List the capability registry
`voss principles show`	Show the active engineering principles

Common flows

voss doctor
voss do "summarize this repo"
voss recall "where is retry backoff handled?"
voss sync --check
voss edit src/app.py
voss sessions
voss resume <session-id>

​Harness commands

​Compiler commands

​Orchestration commands

​Common flows

Harness commands

Compiler commands

Orchestration commands

Common flows