Libra

Overview#

Libra is an evolving AI agent–native version control system maintained by the web3infra-foundation organization. It addresses two core pain points of traditional VCS in the AI era: lack of native AI agent interaction interfaces, and storage/performance bottlenecks in large-scale Monorepo scenarios.

• Primary Language: Rust (99.1%)
• Current Version: 0.1.0
• Development Activity: 142 commits, 60+ contributors, 5 open issues, 1 PR

Core Capabilities#

Git Compatibility#

• Essentially compatible with Git, developed with reference to official Git documentation
• Disk format support: objects, index, pack, pack-index
• Remote operations: supports interaction with standard Git remote repositories (push/pull)
• Worktree management: fully compatible with git worktree subcommand set

AI Agent Integration#

Three operation modes:

1. TUI Mode (default): Interactive terminal UI + background Web server
2. Web Mode: Web server only, suitable for remote development
3. Stdio Mode (MCP): Model Context Protocol server for AI client integration (Claude Desktop, etc.)

Agent Workflow Design#

• Phase 0: Input preprocessing (intent extraction, risk assessment, sandbox environment)
• Phase 1: Planning & task graph generation (DAG generation, execution plan)
• Phase 2: Task execution (context injection, code generation, three-layer validation)
• Phase 3: System-level validation & security audit
• Phase 4: Decision & release (automated/manual review based on risk score)

Storage Architecture Innovation#

• SQLite Database: Uses SQLite to manage config, HEAD, refs, etc., providing unified transactional management
• S3-Compatible Object Storage: Supports AWS S3, Cloudflare R2, MinIO as local storage alternative or supplement
• Tiered Storage: Small objects stored both locally and remotely; large objects stored remotely with local LRU cache

Monorepo Design#

• No submodule/subtree commands
• Simplified dependency management, supports massive repositories, maintains single source of truth

CLI Command Support#

Implemented: init, clone, add, rm, restore, status, clean, stash, lfs, log, show, branch, tag, commit, switch, rebase, merge, reset, cherry-pick, push, fetch, pull, diff, blame, revert, remote, open, config, reflog, worktree

Pending: gc, prune, fsck, maintenance, cat-file, hash-object, rev-parse, rev-list, describe, show-ref, symbolic-ref, verify-pack, pack-objects/unpack-objects, ls-remote, grep, bisect, filter-branch, notes, archive

Quick Start#

# Build
cargo build

# Launch interactive TUI
libra

# Initialize repository
libra init

# Clone repository
libra clone <repository>

# Launch Libra Code (TUI + Web)
libra code

# MCP Stdio mode
libra code --stdio

Claude Desktop Integration#

{
  "mcpServers": {
    "libra": {
      "command": "/path/to/libra",
      "args": ["code", "--stdio"],
      "cwd": "/path/to/your/libra/repo"
    }
  }
}

S3 Storage Configuration#

Use Cases#

1. AI-assisted development: Version control driven by AI agent & human collaboration
2. Large repository management: Version control needs in Monorepo architecture
3. Cloud-native storage: Scenarios requiring S3-compatible storage backends
4. Cross-platform development: Supports Windows/Linux/macOS

Pending Confirmation#

• No official release published yet
• Production readiness needs evaluation (v0.1.0, some Git commands unimplemented)
• No performance comparison data with Git available
• No precompiled binary downloads found; requires building from source
• libra.tools domain is currently parked; relationship to project unclear