传给 Agent 的指令
被采集下来的初始工作指令，和代码放在同一份历史里。
兼容 Git本地优先MIT 许可
记录创作历史。
不只是代码历史。
Git 记住的是改了什么。当越来越多的代码由 Agent 写出，这已经不够了。Libra 还会记录工作是如何完成的，并把这份记录留在你的仓库里。
采集 Claude Code、Codex 与 OpenCode。记录留在仓库中，由你决定何时查看或同步。
02 — 一次提交之外
diff 说明终点，记录说明路径。
采集让已有来源证据可供查看。它不凭空生成计划、测试结果或审批结论。
03 — 缺少的上下文
代码落地了，路径却没有。
Agent 产出变更之后，评审者和下一个 Agent 仍要自己找回当时的依据。
评审变得更难
在缺少意图与证据的情况下评审生成代码，规模一大就只能靠猜。
「为什么」会消失
聊天记录游离在仓库之外。到下一次变更时，推理过程可能已经无处可寻。
溯源不在你手里
归因和审计如果只留在别人的服务里，就不属于你的版本历史。
04 — 照常使用 Agent
为现有 CLI 安装采集钩子。
支持安装钩子的 Agent 是 claude-code、codex 和 opencode。libra agent enable 会启用全部受支持的 Agent；下面的命令只启用一个。
libra agent add claude-codeLibra 只在 .claude/settings.json 写入自己管理的条目。卸载时移除这些条目，不接管其它配置。
启用全部受支持的 Agent：libra agent enable
05 — 在本地查看
会话、检查点，以及默认脱敏的导出。
运行 Agent 之后再检查采集到了什么。只有会话、或导出为空时，用 doctor 做诊断。
阅读 Agent Capture 文档libra agent session list列出已捕获的会话libra agent checkpoint list列出检查点libra agent checkpoint show <checkpoint-id>查看一个检查点libra agent checkpoint export <checkpoint-id>导出默认脱敏的检查点转录libra agent doctor只读诊断采集状态
06 — 为信任而建
兼容 Git。本地优先。失败即关闭。
底层是版本控制，采集层围绕隐私、可移植性和控制权。
兼容 Git
用 libra init --from-git-repository 导入现有仓库。对象格式与 Git 远端兼容，历史和远端一并带来。
开放、可审视的记录
记录以开放格式保存，可以查询和导出。创作历史是你的数据。
默认脱敏
转录和 stderr 会被截断并脱敏。原始导出需要 --allow-raw --raw、理由，并留下审计记录。
失败即关闭
RPC 适配器在被信任之前保持关闭。不受支持的 Agent 会得到可操作的报错，而不是静默降级。
保留策略由你决定
可以用 libra agent clean 清理已停止会话的检查点。只有你执行 libra agent push 时，轨迹引用才会送到远端。
MIT，公开开发
以 MIT 许可公开开发。可以阅读代码、自行构建，也可以 fork。
记录层是当前能力。行级归因、跨历史搜索和团队评审界面是 Libra 公开写出的后续方向，不是这一页已经提供的功能。
07 — 安装、导入、采集
把现有仓库带进 Libra。
安装 CLI，导入 Git 仓库，再为要使用的 Agent 安装钩子。
curl --proto '=https' --tlsv1.2 -sSf https://download.libra.tools/install.sh | shmacOS 与 Linux 的官方安装脚本。
01
导入仓库
从现有 Git 仓库创建 Libra 仓库。
libra init --from-git-repository ./acme ./acme-libra02
采集并查看
安装钩子并重启 Agent 后，列出检查点。把 <checkpoint-id> 换成列表中的 ID。
libra agent checkpoint list
libra agent checkpoint show <checkpoint-id>给仓库一份可以带回的记忆。
Libra 负责记录 Agent 如何完成工作。Mega2 负责保存 Monorepo，ScorpioFS 负责按需挂载工作区。