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.

Voss v0.1 is harness-led, with .voss preserved as the workflow-control language. The current roadmap extends that base with memory, TUI, codebase intelligence, and richer agent capabilities.

Phase order

PhaseNameGoal
M0Scope LockAlign planning docs around harness-led v0.1
M1Harness Happy PathMake voss doctor, voss do, and voss edit usable on a real repo
M2Project CognitionPersist project-local memory, plans, decisions, sessions, and validation state
M3Language ValidationProve .voss workflows check, compile, and run as AI workflow control
M4Voss-authored Harness LoopDogfood the harness loop through .voss files
M5Eval and Distribution PrepTrack quality and prepare packaging after Python harness usage is proven
M6npm WrapperShip @vosslang/cli with vendored Python 3.12 and the Voss wheel
M7SDK PolishStabilize the public Python embedding surface
M8Project MemoryAdd VOSS.md, .voss/memory, recall, save, forget, and memory maintenance commands
M9TUI ShellAdd the Textual interface, permission modals, slash palette, budget view, and session forking
M10Codebase IntelligenceAdd code search, symbol lookup, references, project index, and TUI code panel

Current direction

The harness is the product surface users feel first. The language is the durable control layer. Python remains the canonical implementation path; npm distribution vendors that Python harness rather than reimplementing it in JavaScript.

Deferred work

The following work is strategically relevant but deferred from the first proof loop:
  • Rust as the canonical harness shell
  • MCP bridge before M12
  • Tree-sitter grammar
  • VS Code marketplace release
  • GitHub Linguist upstream PR
  • Broad telemetry
  • Hosted team features
  • Web UI
  • Homebrew distribution
Distribution work should not claim more safety, maturity, or language completeness than the harness currently proves.