Skip to main content

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.

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

Open a repository

Run Voss from the repository you want to inspect.
cd path/to/your/repo
voss doctor
2

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

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

Validate work

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

Resume later

Sessions are persisted per project. List them, then resume by id or name.
voss sessions
voss resume <session-id>
You have completed the core harness loop when Voss can inspect the repo, make a scoped change, run validation, and resume the session.