> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tryvoss.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Harness commands

> Use the Voss harness command surface for planning, editing, diagnostics, sessions, tools, and config.

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](/orchestration/overview) and the [CLI reference](/reference/cli)

## Harness commands

| 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        |

<Warning>
  `voss run` is not an agent command. Natural-language tasks use `voss do`.
</Warning>

## Orchestration commands

For multi-agent team runs — full detail in [Orchestration](/orchestration/overview).

| 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

```bash theme={"theme":"github-dark"}
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>
```