# Warren

> Warren is a self-hostable control plane for ephemeral cloud agents. It clones a GitHub repository, runs a coding agent inside a sandbox, streams the run back to an HTTP API and UI, and pushes the resulting branch as a pull request.

Notes for models reading these docs:

- The documentation is generated from jayminwest/warren at tag v0.11.0. Behaviour on `main` may differ.
- `/docs/api/` is generated from the server's OpenAPI 3.1 schema and is the authoritative HTTP contract.
- `/docs/sdk/` is generated from the TypeScript client's public exports.

## Documentation Sets

- [Abridged documentation](https://warren.run/llms-small.txt): a compact version of the documentation for Warren, with non-essential content removed
- [Complete documentation](https://warren.run/llms-full.txt): the full documentation for Warren

## Notes

- The complete documentation includes all content from the official documentation
- The content is automatically generated from the same source as the official documentation

## Optional

- [warren on GitHub](https://github.com/jayminwest/warren): Source, issues, and releases.