Documentation
Obsidian's documentation covers everything from first installation to the philosophical underpinnings of constitutional consensus. Start at the beginning, or jump to whatever caught your eye in the sidebar.
All Documents
Introduction to Obsidian
What Obsidian is, why it exists, and how it thinks about multi-agent orchestration
Architecture
How Obsidian's components connect — from the Warden's oversight to fractal agent hierarchies
Quick Start
Get Obsidian running in five minutes, understand it in ten
Agent System
Autonomous workers that find work and do it — the stateful, sovereign executors at the heart of Obsidian
CLI Reference
The obs command-line interface — fast, intuitive, and comprehensive control of the entire Obsidian system
Secrets Management
Provider-agnostic secrets with zero trust, encrypted caching, and complete audit trails — because security is structural
Plugin System
Extend Obsidian without modifying core — sandboxed, declarative, and hot-reloadable plugins for every integration
Hook System
The event-driven extension points that let plugins intercept, observe, and transform every significant operation in Obsidian
Model Routing
How Obsidian intelligently routes LLM requests across providers — balancing cost, latency, quality, and availability
Chaos Engineering
Obsidian doesn't hope systems survive failure — it proves they do. Five chaos levels, from gentle probing to full apocalypse simulation, with safety limits that make controlled destruction a routine practice.
Agent Coordination
How autonomous agents discover work, claim tasks, reserve files, communicate asynchronously, and launch coordinated strikes — without stepping on each other or waiting for permission.
Configuration
Six layers of configuration, from system-wide defaults to runtime overrides — with deep merge strategies, dynamic value resolution, conditional blocks, and hot reload. Because configuration is governance in YAML form.
Dashboard & Observability
If it isn't observable, it doesn't exist. Obsidian provides four levels of visibility — from a single terminal status line to a full web dashboard — because blindness is more expensive than storage.
Fractal Architecture
Obsidian managing Obsidian. Instances spawn instances, resources flow downward, escalations flow upward. It's turtles all the way down — and every turtle has a budget.