# Voss Docs

> Documentation for the Voss coding harness and .voss workflow-control language.

## Docs

- [Make your first scoped edit](https://docs.tryvoss.dev/get-started/first-edit.md): Use voss edit to let the harness write only inside an explicit target scope.
- [Run your first task](https://docs.tryvoss.dev/get-started/first-task.md): Use voss do for a bounded one-shot task against a repository.
- [Install Voss](https://docs.tryvoss.dev/get-started/install.md): Install the Voss CLI with npm, pip, or an editable source checkout.
- [Quickstart](https://docs.tryvoss.dev/get-started/quickstart.md): Use Voss to inspect a repo, make a scoped edit, and validate the result.
- [Analyze a repository](https://docs.tryvoss.dev/guides/analyze-a-repo.md): Use Voss to inspect a repository without mutating it.
- [Make a scoped edit](https://docs.tryvoss.dev/guides/scoped-edit.md): Use voss edit to make bounded file changes with test mirrors.
- [Validate and resume work](https://docs.tryvoss.dev/guides/validate-and-resume.md): Close the loop after a Voss harness session.
- [Harness commands](https://docs.tryvoss.dev/harness/commands.md): Use the Voss harness command surface for planning, editing, diagnostics, sessions, tools, and config.
- [Config and auth](https://docs.tryvoss.dev/harness/config-auth.md): Configure model selection and provider access for the Voss harness.
- [Permission modes](https://docs.tryvoss.dev/harness/modes.md): Understand plan, edit, and auto modes in the Voss harness.
- [Harness overview](https://docs.tryvoss.dev/harness/overview.md): Understand the Voss terminal harness and how it differs from open-ended AI chat.
- [Project cognition and memory](https://docs.tryvoss.dev/harness/project-cognition.md): How Voss persists project-local instructions, sessions, plans, and recallable memory.
- [Scoped editing](https://docs.tryvoss.dev/harness/scoped-editing.md): How voss edit limits write access to explicit targets and nearby tests.
- [Sessions](https://docs.tryvoss.dev/harness/sessions.md): List and resume Voss harness sessions.
- [Tool registry](https://docs.tryvoss.dev/harness/tools.md): The controlled tool surface Voss exposes to the harness agent.
- [Voss documentation](https://docs.tryvoss.dev/index.md): Start here for the Voss coding harness and .voss workflow-control language.
- [Compiler and runtime](https://docs.tryvoss.dev/language/compiler-runtime.md): How .voss source moves through parser, analyzer, codegen, and voss_runtime.
- [Core constructs](https://docs.tryvoss.dev/language/core-constructs.md): The .voss language constructs for confidence, context, budgets, routing, agents, memory, tools, and errors.
- [Examples](https://docs.tryvoss.dev/language/examples.md): Canonical .voss examples for classification, support routing, and research agents.
- [.voss overview](https://docs.tryvoss.dev/language/overview.md): Understand .voss as the workflow-control language behind the Voss harness.
- [CLI reference](https://docs.tryvoss.dev/reference/cli.md): Reference for Voss harness and compiler commands.
- [Config and state reference](https://docs.tryvoss.dev/reference/config-state.md): Where Voss stores user config, durable project cognition, sessions, and rebuildable cache.
- [Troubleshooting](https://docs.tryvoss.dev/reference/troubleshooting.md): Common Voss setup, command, permission, and docs issues.
- [Roadmap](https://docs.tryvoss.dev/roadmap/v0-1.md): The Voss roadmap from harness-led v0.1 through TUI and codebase intelligence.
- [Security model](https://docs.tryvoss.dev/security/overview.md): How Voss constrains local agent work through modes, scope, prompts, and session redaction.

## OpenAPI Specs

- [openapi](https://docs.tryvoss.dev/api-reference/openapi.json)