文档

装一次，让 AI agent 每次动手前先看上下文。

人不用记复杂流程。你装好 Mainline 后，agent 负责在关键修改前读历史、在关键节点写记录；人主要用 CLI 和 Hub 看最近发生了什么。

安装

curl -fsSL https://raw.githubusercontent.com/mainline-org/mainline/main/install.sh | bash
mainline doctor --setup

脚本会下载最新 release，并做 checksum 校验。

初始化项目

cd your-repo
mainline init --actor-name "alice"

初始化会写入配置、设置 Git refs、创建本机身份，并安装给 agent 看的使用说明。

人怎么用

mainline hub open
mainline log
mainline show <intent_id>
mainline gaps

打开 Hub 看最近的决策、风险、历史记录，以及哪些 commit 还缺解释。

Agent 怎么用

mainline context --current --json
mainline start "Add JWT auth"
mainline append "Implemented JWT middleware"
mainline seal

agent 先读再写，只记录有工程意义的进展，不记录每一次敲键盘。

什么时候必须先看历史

只要不是小修小补，agent 都应该先问 Mainline。

比如架构调整、重构、迁移、删除代码、权限、账单、数据模型、CI、发布流程，或者任何跨文件行为变化。

只有拼写修正、纯格式化、一眼能看懂的一行语法修复，才适合跳过。