# TOVIO

> TOVIO is an open-core version control system built for AI-assisted development: cryptographically-enforced per-file permissions, capability-token authorization and signed provenance for AI agents, change identity that survives history rewriting, first-class conflict objects, and binary parity without LFS. The engine, CLI, SDKs, and the full specification are Apache-2.0; the collaboration platform (the Forge / TOVIO Cloud) is a commercial product.

Key facts for agents: there is no staging area (the working copy auto-snapshots); branches are called lanes; changes carry stable `chg:` IDs that survive rebase; every command accepts `--json` and errors carry stable `TVO-<AREA>-<NNN>` codes with remediation commands that are runnable verbatim.

## Operating TOVIO as an agent

- [Full agent operating corpus](https://tovio.dev/llms-full.txt): the command surface, alias tables, the --json error contract, exit-code classes, and the recovery index for all 302 catalogued error codes.

## Docs

- [Repository](https://github.com/Tovio-VCS/tovio): the open engine, CLI, SDKs, and specification (Apache-2.0).
- [Conceptual model](https://github.com/Tovio-VCS/tovio/blob/main/docs/concepts/conceptual-model.md): the core ideas in five minutes.
- [CLI specification](https://github.com/Tovio-VCS/tovio/blob/main/docs/specs/cli.md): the governed command surface, tiers, and global conventions.
- [Error catalog](https://github.com/Tovio-VCS/tovio/blob/main/docs/specs/error-catalog.md): every TVO error code with its machine-readable envelope and remediations.
- [Specification index](https://github.com/Tovio-VCS/tovio/blob/main/docs/README.md): the full document set and reading order.
- [Glossary](https://github.com/Tovio-VCS/tovio/blob/main/docs/glossary.md): lane, change, seal, capability token, and the rest of the vocabulary.

GENERATED by scripts/generate_llms_txt.py — do not edit by hand.