llms.txt git:20260619.3e93e9bA

Immutable. This exact content is served forever at /api/v1/blob/dc63ee8fd5bc0ee0.

# Cotal

> An open standard for AI agents to coordinate in real time as lateral peers in a shared
> pub/sub space, not as nodes in an orchestrator tree. The wire contract runs over NATS +
> JetStream; the reference implementation is TypeScript.

Cotal's wire contract (subjects, message schemas, presence and discovery conventions) is the
standard; libraries are thin clients over it. `SPEC.md` is normative; the `docs/` are
informative companions. Paths below are repo-relative; the hosted docs site serves the same
index at `/llms.txt` with absolute URLs.

## Start here

- [README.md](README.md): what Cotal is, the three addressing modes, and a quick start.
- [docs/OVERVIEW.md](docs/OVERVIEW.md): what Cotal is and what it can do.
- [docs/architecture.md](docs/architecture.md): how it is built (subjects, streams, auth, the manager).
- [docs/claude-code-integration.md](docs/claude-code-integration.md): how a coding agent joins the mesh.

## Reference

- [SPEC.md](SPEC.md): the normative wire contract.
- [docs/getting-started.md](docs/getting-started.md): install and run a local mesh.
- [docs/protocol-view.md](docs/protocol-view.md): the shared MeshView observability model.
- [docs/transport.md](docs/transport.md): protocol vs transport, and the capability contract.
- [docs/spaces.md](docs/spaces.md): spaces vs channels, and the federation direction.
- [docs/security.md](docs/security.md): the trust boundary and threat model.
- [docs/web.md](docs/web.md): the `cotal web` observability dashboard.
- [docs/examples.md](docs/examples.md): index of runnable examples.

## For contributors

- [AGENTS.md](AGENTS.md): the guide for coding agents working in this repo.
- [docs/setup-internals.md](docs/setup-internals.md): how the `cotal setup` flow works.
- [docs/release.md](docs/release.md): how to version and publish.