内容
<p align="center">
<img src="docs/public/logo.svg" alt="cairn" width="96" />
</p>
<h1 align="center">cairn</h1>
<p align="center">
仓库原生的任务管理。您的代理和您共享的任务图。
</p>
<p align="center">
<a href="https://github.com/ShahramMebashar/cairn/releases/latest"><strong>下载</strong></a> ·
<a href="https://shahrammebashar.github.io/cairn/">文档</a> ·
<a href="https://shahrammebashar.github.io/cairn/agents/">连接代理</a> ·
<a href="SPEC.md">SPEC</a> ·
<a href="CHANGELOG.md">更新日志</a>
</p>
---
cairn 是一个任务图，它以 **Markdown 文件的形式存放在您的仓库中**。一个 Go 二进制文件（`cairn`）通过 [MCP](https://modelcontextprotocol.io) 为 AI 代理提供服务，通过干净的 Web UI 为人类提供服务。只有一个真实来源：文件。只有一个规则集：`internal/task`。没有数据库。
- **存放在您的仓库中**。任务是 Markdown（机器使用 YAML 前置信息，人类使用正文）。任务像代码一样分支、合并和审查；任务的历史记录是其 Git 历史记录。
- **为代理而构建**。代理列出准备好的工作，认领它，运行带有心跳的可观察会话，并移交给审查。每次写入都由创建它的执行者标记。
- **一个规则集，两个前端**。Web UI 和 MCP 服务器是同一个引擎上的薄适配器，因此代理和人类始终看到相同的关口和相同的准备度。
- **一键连接任何代理**。连接页面检测已安装的代理，并为您编写它们的 MCP 配置，每个配置都在其自己的身份下。
## 快速开始
```sh
make build # -> bin/cairn
cairn web --repo . # 在浏览器中打开面板
```
然后打开 **连接** 页面并一键连接代理，或手动连接：
```sh
claude mcp add cairn -- "$(pwd)/bin/cairn" serve --actor agent:claude --repo "$(pwd)"
```
完整的操作指南： **[安装](https://shahrammebashar.github.io/cairn/installation)** →
**[快速开始](https://shahrammebashar.github.io/cairn/quickstart)**。
## 以您喜欢的方式运行
| | 方法 | 用途 |
| --- | --- | --- |
| 桌面应用程序 | [**下载**](https://github.com/ShahramMebashar/cairn/releases/latest)（macOS / Windows / Linux） | 原生窗口 + 托盘；自动更新 |
| Web UI | `cairn web --repo .` | 在浏览器中打开面板 |
| MCP 服务器 | `cairn serve --actor agent:x --repo .` | 无头，由代理启动 |
## 支持的代理
一键连接 **Claude Code, Cursor, Codex, Windsurf, OpenCode, Kilo Code, 和 Pi**；复制粘贴指南适用于 **Antigravity** 和任何其他 MCP 客户端。查看 [代理指南](https://shahrammebashar.github.io/cairn/agents/)。
## 开发
```sh
make check # gofmt + go vet + go test ./...
make web-dev # Vite 开发服务器（代理 /api -> :8080）
make desktop-dev # 对开发服务器的原生窗口
```
此仓库自我托管 cairn：其自身工作在 `.cairn/` 中跟踪。查看 [AGENTS.md](AGENTS.md) 和 [.cairn/WORKFLOW.md](.cairn/WORKFLOW.md)。
## 安全
cairn 是一个 **本地、单用户** 工具，设计上没有身份验证。查看 [SECURITY.md](SECURITY.md) 以了解信任模型和如何报告漏洞。
## 许可证
[MIT](LICENSE)。
