# Weave

> Weave is version control for people and AI agents editing one codebase at the same time. It works by symbol (function, class, constant, JSON key), keeps workstreams in sync in real time and gives every symbol an owner, so nobody merges and nobody's work is lost.

Every page is also available as plain Markdown at /docs/<page>.md. All pages in one file: https://www.weave.directory/docs/llms-full.txt

## Docs

- [Overview](https://www.weave.directory/docs/overview.md): What Weave is, how it differs from git, and the core concepts — workstream, draft, stitch, weave, owner, suggestion — with a glossary.
- [Quickstart](https://www.weave.directory/docs/quickstart.md): Sign up, create an organization and a repository, install the CLI, clone, edit, add, stitch, and see your change on weave.directory.
- [Workstreams](https://www.weave.directory/docs/workstreams.md): The main ← preprod ← dev chain, promote and inherit, ownership and inherit settings, protected workstreams, removing and restoring.
- [Working together](https://www.weave.directory/docs/working-together.md): Claims, owners and leases, suggestions, change requests, clashes that never block, resolution points, held edits, sync, drafts, adopt, messages and notices.
- [Decisions & history](https://www.weave.directory/docs/decisions-and-history.md): Decision records, the operation log, timeline, blame and symbol history, revert and undo, tags and attestations.
- [Search](https://www.weave.directory/docs/search.md): Semantic code search (weave search, search_code), keyword find, and what is indexed: stitched workstream heads, never drafts.
- [For AI agents](https://www.weave.directory/docs/agents.md): Sessions, registered agents and agent tokens, pathScope, the MCP server and every tool, orientation commands, --json, weave serve, parallel stitching, retries and a recommended workflow.
- [Security & access](https://www.weave.directory/docs/security.md): Token types (personal, agent, service), scopes, repository and route limits, 2FA, the secret check and allowSecret, lawful purge and the audit trail.
- [API reference](https://www.weave.directory/docs/api.md): The platform REST API (/api/v1) and the Weave server API (/api/weave/{repoId}/…): auth, requests, responses, error shapes and codes.
- [Webhooks & events](https://www.weave.directory/docs/webhooks.md): Event names, delivery payloads, signing and verification, retries, the deliveries API, and polling or replaying events.
- [CLI reference](https://www.weave.directory/docs/cli.md): Every weave command grouped by task, with flags, JSON output and environment variables.
- [Troubleshooting & FAQ](https://www.weave.directory/docs/troubleshooting.md): Common errors and what to do, compatibility between CLI and server versions, and frequently asked questions.

## Optional

- [Install the CLI](https://weave-cli.com/docs/install): installers for macOS, Linux and Windows.