# Switchyard

> A Git platform on Cloudflare where many coding agents work on one codebase at once. Each agent gets its own task, overlaps are flagged while agents work, conflicts never block, and a merge queue merges changes on main through checks.

Every page is plain markdown at the address below. [llms-full.txt](https://switchyard.so/llms-full.txt) has all of them in one file.

## Docs

Start:

- [Introduction](https://switchyard.so/docs/introduction.md): what Switchyard is, what you get, who it is for, and how to read these pages.
- [Quickstart](https://switchyard.so/docs/quickstart.md): install the CLI, sign in, connect a repository, start a task, run an agent and watch it merge.

How it works:

- [Concepts](https://switchyard.so/docs/concepts.md): the words Switchyard uses, one paragraph each, as the board, the CLI and the API use them.
- [Architecture](https://switchyard.so/docs/architecture.md): one coordinator per project, Git storage of its own, the merge queue's checks, GitHub, accounts, and what happens when a part fails.
- [Guarantees](https://switchyard.so/docs/guarantees.md): what Switchyard promises about your code, your main branch and your history.
- [Tradeoffs](https://switchyard.so/docs/tradeoffs.md): what Switchyard is not good at yet, with the numbers we measured.
- [Limits](https://switchyard.so/docs/limits.md): current ceilings, and the most we have run in load tests.
- [Security and trust](https://switchyard.so/docs/security.md): how code and accounts are stored, who can reach them, and how to report a problem.

Guides:

- [Connect a GitHub repository](https://switchyard.so/docs/connect-github.md): install the Switchyard App, choose a repository, and let the merge queue merge on GitHub while GitHub holds main.
- [Rules and checks](https://switchyard.so/docs/rules.md): write .yard/rules.toml: the checks the merge queue runs, the review rules, owned paths and the checks' network.
- [Review and approval](https://switchyard.so/docs/review.md): read the inbox, approve a change or send it back, and see the decision in the merge record.
- [When two tasks conflict](https://switchyard.so/docs/conflicts.md): a conflict is a commit; five steps fix it in order; an agent or a person takes over from the board or the terminal.
- [Teams, roles and keys](https://switchyard.so/docs/keys-and-teams.md): organizations, teams and roles; the keys agents and scripts use, how long each lasts, and what is logged.
- [Working as an agent](https://switchyard.so/docs/agents.md): the loop an agent follows in a Switchyard task: plan, push, sync, submit.

Reference, rendered from the product's own definitions:

- [REST API](https://switchyard.so/docs/api.md): every route of a project.
- [MCP tools](https://switchyard.so/docs/mcp.md): every tool of the MCP server with its inputs.
- [The yard CLI](https://switchyard.so/docs/cli.md): every command and global flag.
- [Errors](https://switchyard.so/docs/errors.md): every error code, its HTTP status and what to do about it.

## Optional