1
Open a repository
Run Voss from the repository you want to inspect.
2
Ask for a read-only summary
voss do defaults to plan mode, so mutating tools are denied unless you choose a different mode.3
Open a scoped edit session
Name the file or directory Voss may edit.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.5
Resume later
Sessions are persisted per project. List them, then resume by id or name.
You have completed the core harness loop when Voss can inspect the repo, make a scoped change, run validation, and resume the session.