Quickstart

This quickstart shows the v0.1 harness loop: inspect, plan, edit, validate, and resume.

Open a repository

Run Voss from the repository you want to inspect.

cd path/to/your/repo
voss doctor
voss login

voss login is only needed when no Claude, Codex, or API key credentials are found.

Ask for a read-only summary

voss do defaults to plan mode, so mutating tools are denied unless you choose a different mode.

voss do "summarize this repo and name the highest-risk areas"

Open a scoped edit session

Name the file or directory Voss may edit.

voss edit src/example.py

Voss can write the target and existing nearby test mirrors. Other writes require explicit scope expansion.

Validate work

Use the repo’s normal checks. For Voss language files, use voss check.

voss check .
pytest -q

Resume later

Sessions are persisted per project. List them, then resume by id or name.

voss sessions
voss resume <session-id>

In the Go terminal client, /resume opens a picker over saved sessions.

Run bare voss for the full-screen Go terminal client. It uses the same harness loop, sessions, and permission prompts as voss do and voss chat.

You have completed the core harness loop when Voss can inspect the repo, make a scoped change, run validation, and resume the session.