Skip to main content
The Voss harness is a terminal-native agent loop for bounded, inspectable, resumable repo work. It is the single-agent substrate the orchestration layer builds on: a team run is many of these loops, each a scoped node in a session tree. It is not a general chat box. Each turn goes through a small set of explicit systems:

​
Why it exists

AI coding tools are useful, but many hide important decisions in prompts:
  • What can the agent edit?
  • Which commands can it run?
  • What context did it inspect?
  • Which files did it avoid?
  • Can the session be resumed later?
Voss makes those decisions explicit through commands, modes, tool classification, permission prompts, persistent project context, and resumable sessions.

​
Main commands

voss do

Run one natural-language task and exit.

voss chat

Start an interactive harness REPL.

voss edit

Open a scoped edit session around explicit targets.

voss sessions

List and resume prior harness work.

voss team run

Run a goal as a whole team built from these loops.

​
Product shape

The harness is the substrate; the orchestration layer is the product built on top of it. One harness loop is a single bounded agent. A team run dispatches many of them under an Engineering Manager loop, each owning a scoped, budgeted node in the session tree, gated by independent review. The Python harness is the canonical behavior source and the npm CLI vendors that implementation. The .voss language is the control layer at both levels — confidence, context budgets, routing, memory, tools, and fallbacks for one agent; roles, principles, and gates for a team.