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.

Project cognition is the project-local state Voss uses to avoid starting from zero every session.

​
Durable state

Human-readable project context lives in VOSS.md. Machine-managed durable state lives under .voss/: 
VOSS.md
.voss/
  permissions.yml
  validation.yml
  memory/
  plans/
  sessions/
  decisions/
VOSS.md can include human prose plus machine-managed fenced sections such as architecture notes. Legacy .voss/architecture.md content is migrated into the VOSS.md architecture fence.

​
Rebuildable state

Machine-generated indexes and cache files live under .voss-cache/: 
.voss-cache/
  repo.idx
  harness/
This state should be safe to delete and rebuild.

​
What Voss records

Agent runs can record:
  • Task goal
  • Plan
  • Inspected files
  • Changed files
  • Avoided files
  • Assumptions
  • Decisions
  • Risks
  • Validation
  • Failures
  • Diff summary
  • Follow-ups

​
Memory commands

Inside a harness session: 
/recall <query>
/memory
/save <note>
/forget <pattern> --yes
From the CLI: 
voss memory size
voss memory vacuum
voss memory adopt --id <fence-id>