libra-tools/libra
libra-tools/libra has 100 GitHub stars and 160 forks. GitHot measured 0 stars in 24 hours. Last checked 2026-11-18 08:56 UTC. Last push 2026-11-15.
实测星标增长
- 24小时
- 0
- 7天
- 正在收集历史
- 15天
- 正在收集历史
- 1个月
- 正在收集历史
各周期内的星标净变化,周期相互重叠,并非每日新增。缺失的测量保持空白。星标代表关注度,不代表软件质量。
关于
Libra is evolving into an AI agent–native version control tools
开发工具README.zh-CN.md
原文English | 中文

Libra — 面向 AI Agent 的 AI 原生扩展版本控制系统
版本化整个软件创造生命周期,而非仅仅是代码。
Libra 是 AI 原生版本控制系统,将兼容 Git 的代码历史与外部 AI 编程 Agent 捕获结合起来。它记录受支持 Agent 的会话、检查点元数据,并在会话内容可捕获时将脱敏快照存入 refs/libra/traces,让开发者可以查阅变更背景,并随仓库保存这些历史。
Libra 的对象格式和传输协议兼容 Git,可融入现有开发流程。捕获 hook 支持 Claude Code、Codex 和 OpenCode;这些工具负责运行编程 Agent,Libra 负责记录其工作。
coverage-v2 源码版本: 下文 coverage-v2 说明对应 Libra 0.30.50 源码线及后续兼容版本,不宣告稳定版已发布;可用性以官方发布及
libra --version为准。其它章节保留各自的版本要求;coverage-v2 不证明 native 来源,也不准入原生 reasoning artifact。
Libra 0.30.50 的 coverage-v2 采集会保留脱敏后的 OpenCode 可读
reasoning typed turn,普通 v1 字节保持不变。中断的旧动作先结算原回执,之后的新动作
可一次性重采 reasoning。如果已有 v2 历史的 Session 来源被拒绝,采集会停止;请使用
libra agent doctor 检查并新建 Session。native 证明字段仍需独立来源验证,详见
采集命令文档。
核心差异
| 能力 | 传统版本控制(Git) | Libra |
|---|---|---|
| 版本化内容 | 代码历史 | 代码历史 + 捕获的 Agent 检查点和脱敏会话记录 |
| AI 协作 | 手动提交信息 | 外部 Agent 会话与检查点历史 |
| 知识复用 | 代码快照 | 可随仓库历史查阅的捕获上下文 |
| 安全 | 外部 GPG/SSH 配置 | 内置 Vault,每个仓库独立隔离密钥 |
| Agent 集成 | 不适用 | Claude Code、Codex 和 OpenCode 捕获 hook |
| 自动化 | 外部 CI/CD | 仓库级 Cron 与 VCS 事件规则 |
快速开始
安装
# macOS(Apple Silicon)/ Linux(amd64、arm64,推荐)
# Intel macOS 无预编译二进制,请按下方步骤从源码构建。
# 安装器先验证 Ed25519 签名的 release manifest 及二进制 sha256/size 再安装;
# 信任模型见 docs/installation.zh-CN.md。
curl -fsSL https://download.libra.tools/install.sh | sh
# Homebrew(macOS)
brew install libra-tools/libra/libra
# 从源码编译(需要 Rust)
git clone https://github.com/libra-tools/libra.git
cd libra
cargo build --release --locked
源码构建生成 target/release/libra;可直接运行该二进制,或运行
cargo install --path . --locked 将其安装到 Cargo 的二进制目录。
脚本安装器还会创建可选短命令 ~/.libra/bin/lba -> libra(相对 symlink)。
重复安装同一版本会修复缺失的 alias,不替换二进制。使用 --no-alias 或
LIBRA_NO_ALIAS=1 可关闭;已存在的用户自有 lba 绝不会被覆盖。详见
安装器行为与选项。
初始化你的第一个仓库
# 创建新的 Libra 仓库
libra init my-project
cd my-project
# 或从现有 Git 仓库转换
libra init --from-git-repository /path/to/existing/git/repo
使用 Agent 捕获
# 登记 OpenCode exporter 信任(请按实际安装位置调整目录)
libra agent rpc trust --dir "$HOME/.opencode/bin"
libra agent rpc trust opencode
# 安装当前仓库的捕获插件,然后检查安装状态
libra agent add opencode
libra agent list
libra agent doctor
# 在当前仓库中启动 OpenCode,完成一轮对话后退出
opencode
# 查看已捕获的会话和检查点
libra agent session list
libra agent checkpoint list
如果实际安装位置与上面的路径不同,请使用 OpenCode 可执行文件所在的目录。
安装插件后再启动 OpenCode;--pure / OPENCODE_PURE=1 会禁用捕获。
查看 Agent 命令指南,了解支持的 Agent、提供商配置和会话管理。
核心特性
🧠 外部 Agent 捕获与 traces 历史
libra agent 记录受支持的外部编程 Agent 的会话和检查点。检查点元数据保存在本地索引中;会话内容可捕获时,脱敏快照作为仓库对象存储,可从 refs/libra/traces 到达。可用 libra agent session、checkpoint 和 doctor 查阅捕获状态,用 libra agent push 将 traces 推送到远端。
libra review 和 libra investigate 在隔离工作空间中调用受支持的外部 Agent CLI,执行只读审查与调查。libra agent bridge --stdio 通过 JSON-RPC 提供仓库级 DeepSeek Harness bridge。详见 review、investigate 和 agent 指南。
原有 libra code UI/执行器和 libra publish 站点宿主已在 0.23.x 移除。外部 Agent 捕获使用 libra agent;仓库备份使用 libra cloud。
.libra/
├── libra.db # SQLite:VCS 状态 + Agent 捕获元数据
├── vault.db # 加密的签名密钥与认证凭据
├── objects/ # 对象存储(loose + pack,与 Git 兼容)
└── sessions/agent/ # 本地 Agent 捕获事件日志
🔄 Git 兼容基础
Libra 使用兼容 Git 的对象、索引和 pack 格式,支持与 GitHub、GitLab、Gitea 等服务器进行 Git 远程协作。命令和参数的支持程度各不相同;具体行为与限制见兼容性矩阵。
关键区别:Git 管理文件。Libra 管理创造。
🔐 Vault 安全
默认情况下,libra init 会创建仓库级加密密钥库并生成 GPG 签名密钥。SSH 认证密钥需另行运行 libra config generate-ssh-key --remote origin 生成。签名和认证密钥按仓库隔离,详见配置指南。
🛡️ 沙箱诊断
libra sandbox status 报告申请使用 Libra 内部沙箱的操作可用的后端与执行策略。外部编程 Agent 仍使用各自的执行与安全策略。
☁️ 分层云存储与备份
- 分层存储:将大对象卸载到 S3/R2/RustFS,本地 LRU 缓存
- 云端备份:将仓库对象、引用和已捕获的 Agent 历史同步到 Cloudflare D1 + R2
- 可移植:在另一台机器上恢复已备份的仓库状态和捕获上下文
远端 Mega2 浏览器
libra mega2 browser --server http://127.0.0.1:9000 打开左侧目录树、右侧只读文件
内容的终端界面。Enter/右方向键展开目录,选中文件自动预览,Tab 切换左右焦点。
预览按代码/配置文件类型进行语法高亮,--no-color 可关闭颜色。
文本预览上限为 256 KiB,无需 clone 或本地仓库;脚本使用的 --list/--json
仍只返回一层目录。按键和限制见浏览器指南。
按 a 新建目录、m 移动文件或目录、e 重命名目录,或先按 t 再按 a 新建 tag;均无需 Shift。
名称和 tag 说明通过居中弹出框输入。移动使用独立的目标目录选择器:右方向键浏览、
第一个 Enter 选择目标、第二个 Enter 确认;Esc 返回或取消。
支持的外部 Agent
当前支持 Claude Code、Codex 和 OpenCode 捕获。运行 libra agent list --schema-version 2 --json 可查看安装状态和导入/导出能力。
当前 macOS 普通 OpenCode 捕获基线为官方 OpenCode 2.0.29 与 Libra 0.30.49。Session 目录过滤、受支持包管理器启动器中的原生可执行文件选择及 metadata-only 空导出警告需要 Libra 0.30.50 或后续版本。请按 exporter 信任与捕获插件配置完成准备;opencode --pure 会禁用捕获。安全的普通检查点会丢弃不支持的 reasoning state 及其关联文本/时间,状态仍为 Unproven / Partial。含不支持 reasoning state 的历史导入仍返回 LBR-AGENT-020。该普通路径不准入原生 signature、redactedData 或 reasoningEncryptedContent artifact,也不证明完整 reasoning 覆盖;原生来源证明仍未通过。
查看 Agent 命令指南,了解提供商配置、捕获边界和会话管理。
社区与资源
| 资源 | 链接 |
|---|---|
| 官网 | libra.tools |
| 文档 | docs.libra.tools |
| Discord | 加入社区 |
| X / Twitter | @git_mono_AI |
贡献指南
我们欢迎来自开发者、AI 研究人员和所有热爱软件创造未来的人的贡献。在提交 Pull Request 之前,请确保你的代码通过我们的质量检查:
# 运行 clippy,所有警告视为错误
cargo clippy --all-targets --all-features -- -D warnings
# 检查代码格式(需要 nightly 工具链)
cargo +nightly fmt --all --check
# 如需要自动修复格式
cargo +nightly fmt --all
# 运行默认验收测试
cargo test --all
Windows 安装方法见 Windows 安装说明。
详细贡献指南请参见 贡献指南。
许可证
MIT 许可证 — 详情见 LICENSE。
Copyright (c) 2025-2026 Web3 Infrastructure Foundation.
Copyright (c) 2026 GitMono Limited.
开始使用 · 加入 Discord · 关注 X