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.

​
User config

Harness config lives under the user’s config directory: 
~/.config/voss/config.toml
Use: 
voss config
voss config --show

​
Project state

Durable project state is split between human-readable VOSS.md and machine-managed .voss/ directories: 
VOSS.md
.voss/
  constraints.yml
  permissions.yml
  validation.yml
  memory/
  plans/
  sessions/
  decisions/
VOSS.md is injected into harness context at session start. Machine fences inside it let Voss update architecture notes without overwriting surrounding human prose.

​
Cache state

Rebuildable state belongs under .voss-cache/: 
.voss-cache/
  repo.idx
  harness/
  code/
You should be able to delete cache state and rebuild it.

​
Session state

Current project sessions live under .voss/sessions/. Legacy sessions in the old user-state directory are read-only via voss sessions --all.
Do not commit secrets to VOSS.md, .voss/, or .voss-cache/. Voss avoids storing provider credentials, but prompt text and project notes are still local files.