LibraLibra
LibraLibra
DocsBlogLibra
Getting Started
Architecture
Design
Commands
API Reference
Policy

Architecture

How Libra is built and why it differs from Git

Libra is designed to stay broadly compatible with Git while evolving into an AI agent–native version control workflow.

Key Ideas

  • Git interoperability: supports core on-disk formats such as objects, index, pack, and pack-index
  • Transactional metadata: uses SQLite to manage refs/config/HEAD-style state instead of loose text files
  • AI-first UX: libra code provides TUI, web, and MCP stdio modes for human + agent collaboration
  • Security by default: repository-local vault-backed signing and key management
  • Scalable storage: optional S3/R2-compatible object storage and cloud sync workflows

Use Agent Capture

Enable external-agent capture with libra agent

Design

Design principles behind an AI agent–native VCS

On this page

Key Ideas