Getting Started

This guide helps you install Libra and run your first end-to-end workflow, from initializing a repository to using AI-native collaboration modes.

Install

Use the official installer:

curl --proto '=https' --tlsv1.2 -sSf https://download.libra.tools/install.sh | sh

If you prefer to review the installer before running it:

curl -fsSL https://download.libra.tools/install.sh

Verify

libra --version
libra --help

First Repository

Initialize a new repository:

mkdir my-repo
cd my-repo
libra init

Or clone an existing repo:

libra clone https://github.com/libra-tools/libra
cd libra

External Agent Capture

Install capture hooks for supported external agent tools, then inspect sessions and checkpoints:

libra agent list
libra agent add codex
libra agent session list
libra agent checkpoint list

Read the step-by-step guide: Use Agent Capture.

Next Steps

• Command reference: Commands
• Agent capture guide: Use Agent Capture
• Design docs: Design
• Policies: Policy