voss do runs one natural-language harness turn and exits. It is the right command when you want a focused answer or plan without entering a REPL.
Run a read-only repo task
By default, voss do runs in plan mode. Voss may inspect files and git state, but mutating tools are denied.
Use it with git diffs
Voss should treat piped input as task context and return a concise answer.
When to use voss do
- Summarize a repository or diff
- Ask for a plan before editing
- Inspect architecture
- Prepare a pull request description
- Run a single, bounded task in a script
Do not use voss run for natural-language work. voss run <file.voss> is reserved for executing .voss programs.
