v0.30.49 · 开源 · 本地优先 · MIT 许可

记录创作历史,
而不只是代码历史。

Git 记住的是改了什么。当越来越多的代码由 Agent 写出,这已经不够了。Libra 是一款 AI 原生、兼容 Git 的版本控制系统,它还会记录工作是如何完成的——并把这份记忆保存在你的仓库里。

$curl --proto '=https' --tlsv1.2 -sSf https://download.libra.tools/install.sh | sh
或使用 Homebrew
$brew tap libra-tools/libra && brew install libra
libra — ~/projects/acmecapture
记录你已经在用的 Agent —— 无需改变工作流
Claude CodeCodexOpenCode
diff 不再是故事的全部

一次提交只说明代码落在哪里,却没说它如何走到这一步。

当 Agent 产出一个 600 行的变更时,diff 告诉你终点,却隐藏了航迹——促成变更的对话与工具活动。采集让已有来源证据可供查看,不凭空生成计划、测试结果或审批结论。

评审变得更难

在缺少意图与证据的情况下评审生成代码,规模一大就只能靠猜。

「为什么」蒸发了

聊天记录游离在仓库之外,随时会消失。到下一个 PR 时,推理过程已无处可寻。

溯源无法自主掌控

归因与审计线索躺在别人的 SaaS 里,而不在你自己的版本控制中。

commita4f2c91refactor auth
prompt传给 Agent 的指令
sessionAgent 身份与已采集的对话
tools可获取的工具事件与结果
checkpoint已捕获的来源及文件元数据
export限长、脱敏的转录
保留已采集的上下文,与代码放在一起。
捕获与查看

照常使用 Agent,留下工作历史

按需启用 Claude Code、Codex 和 OpenCode 的本地采集。在 Libra 中查看会话、检查点,导出限长、脱敏的转录,并自主决定是否共享。

01 · 启用采集

为现有 CLI 安装钩子

在仓库内运行 libra agent add opencode 安装插件,并在该目录重启 OpenCode。OpenCode 2.0.29 支持普通会话内容采集;模型原生 reasoning 字段需要另行验证支持。

$ libra agent add opencodeOpenCode 插件
claude-codecodexopencode
OpenCode --pure 会禁用采集。导出转录还需登记 exporter 目录和可执行文件的信任,详见 Agent Capture 文档。
02 · 本地查看

会话、检查点与转录导出

列出捕获的会话,按 ID 查看检查点并导出脱敏转录。agent doctor 用于采集诊断,JSON agent list schema 2 用于检查 exporter 就绪状态;空输出不能视为采集成功。

$ libra agent session list
$ libra agent checkpoint list
$ libra agent checkpoint export <id> -o checkpoint.jsonl
$ libra agent doctor
$ libra --json agent list --schema-version 2
用列表中的检查点 ID 替换 <id>。原始导出需显式参数、理由和输出文件。数据由你决定何时同步。
为信任而构建

兼容 Git。本地优先。失败即关闭。

底层是一个真正的版本控制系统,其上的捕获层围绕隐私、可移植性与控制权设计。

兼容 Git

导入现有 Git 仓库并继续工作。Libra 使用 Git 的对象模型,你的历史与远端都会一并带来。

cloneinit --from-git-repositorypush

开放、可审视的格式

记录是类型化的、以开放格式存储——可查询、可导出。你的创作历史是你拥有的数据,而非厂商的黑盒。

类型化记录JSON 导出无锁定

默认脱敏

转录与 stderr 会被截断并脱敏;导出原始数据需要显式参数,并会留下审计记录。

失败即关闭

RPC 适配器在被信任之前保持关闭;不支持的 Agent 会得到可操作的报错,绝不静默降级。

保留策略由你掌控

清理已停止会话的检查点、按时间做垃圾回收,只有你决定时才把轨迹引用推送到远端。

MIT 许可,公开开发

以宽松的 MIT 许可在公开环境中开发。阅读代码、自托管、fork——记录层属于每一位使用者。

MIT可自托管libra-tools/libra

未来方向

记录层只是地基。接下来:行级归因、跨创作历史的搜索,以及面向 Agent 规模工作的团队评审界面。

行级归因历史搜索评审界面
一分钟内上手

安装、导入、捕获

把现有项目带入 Libra,开始记录 Agent 的工作——无需改变你运行它们的方式。

STEP 01

安装

# 官方安装脚本
$ curl --proto '=https' \
  --tlsv1.2 -sSf \
  https://download.libra.tools/install.sh | sh
# 或使用 Homebrew
$ brew tap libra-tools/libra
$ brew install libra
# 或 Windows(PowerShell)
PS> irm https://download.libra.tools/install.ps1 | iex
STEP 02

导入你的仓库

$ libra init \
  --from-git-repository ./acme \
  ./acme-libra
$ cd acme-libra
STEP 03

捕获与查看

$ libra agent rpc trust --dir "$(dirname "$(which opencode)")"
$ libra agent rpc trust opencode
$ libra agent add opencode
# 在本仓库重启 OpenCode,不使用 --pure
$ libra agent checkpoint list
$ libra agent checkpoint show <id>

给你的仓库
一份记忆。

开源、本地优先、MIT 许可。为 Agent 构建的一切保留「如何做」——而不只是「做了什么」。

加入 Discord 社区,和我们一起交流