Quick Start

Prerequisites

Rust (stable, 1.75+)
cargo (comes with Rust)
A terminal and the conviction that multi-agent systems should be built on firm foundations

Installation

# Clone the repository
git clone https://github.com/CommanderCrowCode/obsidian.git
cd obsidian

# Build the obs CLI
cargo build --release

# Verify installation
./target/release/obs --version

Initialize a Project

# Create a new Obsidian-managed project
obs init my-project

# This creates:
# my-project/
# ├── .obsidian/
# │   ├── config.toml     # Project configuration
# │   ├── context.md       # Project context for agents
# │   └── tasks/           # Task queue
# └── ...your project files

Your First Task

# Submit a task to the system
obs task create "Analyze the project structure and suggest improvements"

# Check task status
obs status

# The Warden assigns the task to an appropriate agent,
# which executes it under constitutional oversight.

What Happens Under the Hood

When you submit a task, the Warden evaluates it against the Constitution — the twelve principles that govern all agent behavior. If the task is constitutional (most are), it enters the task pipeline where consensus determines assignment.

The assigned agent may create sub-tasks through fractal delegation , spawning child agents that inherit the parent’s constitutional obligations. The whole thing is recursive, auditable, and — critically — correct.

Next Steps

Read the Architecture overview to understand how pieces connect
Explore The Constitution to understand what governs agent behavior
Check the Glossary when you encounter unfamiliar terminology