Open · Local-first · MIT-licensed

Creation history,
not just code history

Git remembers what changed. As agents write more of the code, that's no longer enough. Libra is an AI-native, Git-compatible version control system that also records how the work was made — and keeps that memory in your repo.

$curl --proto '=https' --tlsv1.2 -sSf https://download.libra.tools/install.sh | sh
or with Homebrew
$brew tap libra-tools/libra && brew install libra
libra — ~/projects/acmecapture
Records the agents you already run — no workflow change
Claude CodeCodexOpenCode
The diff is no longer the whole story

A commit says where the code landed. Not how it got there.

When an agent produces a 600-line change, the diff tells you the destination but hides the flight path — the conversation and tool activity that led to it. Capture makes the available source evidence inspectable; it does not invent plans, test results or approvals.

Reviews got harder

Reviewing generated code without its intent and evidence is guesswork at scale.

The "why" evaporates

Chat logs live outside the repo and disappear. The reasoning is gone by the next PR.

Provenance is unownable

Attribution and audit trails sit in someone else's SaaS, not in your version control.

commita4f2c91refactor auth
promptThe instruction supplied to the agent
sessionAgent identity and captured turns
toolsAvailable tool events and results
checkpointCaptured source and file metadata
exportCapped, redacted transcript
Keep the captured context beside the code.
Capture and inspect

Keep your agent workflow. Keep its history.

Opt in to local capture for Claude Code, Codex and OpenCode. Inspect sessions and checkpoints in Libra, with capped, redacted transcript exports and explicit control over sharing. DeepSeek Harness is a separate bundle, not a libra agent add hook.

01 · Enable capture

Hooks for the CLIs you use

Install the OpenCode plugin in your repository with libra agent add opencode, then restart OpenCode there. OpenCode 2.0.29 can capture ordinary session content; reasoning-provider fields require separate verified support.

$ libra agent add opencodeOpenCode plugin
claude-codecodexopencode
OpenCode --pure disables capture. Exporting transcripts also requires trusting the exporter directory and binary; see the Agent Capture guide.
02 · Inspect locally

Sessions, checkpoints and exports

List captured sessions, inspect checkpoints by ID, and export a redacted transcript. Use agent doctor for capture diagnostics and JSON agent list schema 2 for exporter readiness; an empty export is not proof of success.

$ 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
Replace <id> with a listed checkpoint ID. Raw export requires explicit flags, a justification and a file. Data stays local until you choose to sync it.
Preview03 · Separate bundle

DeepSeek Harness

DeepSeek Harness connects through the independent @libra-tools/dsh-bundle package. It is not a capture hook, and libra agent add does not install it.

@libra-tools/dsh-bundle
Available capabilities follow the development build and negotiation. Memory is not a released stable version.
DeepSeek Harness guide
Built to be trusted

Git-compatible. Local-first. Fails closed.

A real version control system underneath, with a capture layer designed around privacy, portability and control.

Git-compatible

Import an existing Git repository and keep working. Libra speaks Git's object model, so your history and remotes come along.

cloneinit --from-git-repositorypush

Open, inspectable format

Records are typed and stored in the open — queryable and exportable. Your creation history is data you own, not a vendor's black box.

typed recordsjson exportno lock-in

Redacted by default

Transcript and stderr are capped and redacted; raw export needs explicit flags and an audit entry.

Fails closed

RPC adapters are off until trusted; unsupported agents are refused with actionable errors, never silent fallbacks.

You control retention

Clean stopped-session checkpoints, garbage-collect by age, and push trace refs to a remote only when you decide.

MIT-licensed & open

Developed in the open under a permissive MIT license. Read the code, self-host it, fork it — the record layer belongs to everyone who uses it.

MITself-hostablelibra-tools/libra

Where it's heading

The record layer is the foundation. Next: line-level attribution, search across creation history, and team review surfaces for agent-scale work.

line attributionhistory searchreview surfaces
Up and running in a minute

Install, import, capture

Bring an existing project into Libra and start recording your agents' work — without changing how you run them.

Step 01

Install

# official installer
$ curl --proto '=https' \
  --tlsv1.2 -sSf \
  https://download.libra.tools/install.sh | sh
# or Homebrew
$ brew tap libra-tools/libra
$ brew install libra
# or Windows (PowerShell)
PS> irm https://download.libra.tools/install.ps1 | iex
Step 02

Import your repo

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

Capture & inspect

$ libra agent rpc trust --dir "$(dirname "$(which opencode)")"
$ libra agent rpc trust opencode
$ libra agent add opencode
# restart OpenCode here; do not use --pure
$ libra agent checkpoint list
$ libra agent checkpoint show <id>

Give your repo
a memory

Open, local-first, and MIT-licensed. Keep the how — not just the what — of everything your agents build.

Join our community on Discord