fab Documentation
fab is a coding agent supervisor that manages multiple Claude Code or Codex instances across projects with automatic task orchestration. It spawns agents in isolated git worktrees, assigns them issues from your tracker, and coordinates their work back to your main branch.
New to fab? Start with the Getting Started guide.
How It Works
- fab creates a pool of git worktrees for each registered project
- When orchestration starts, agents spawn and pick up issues from your tracker
- Each agent works in isolation—implementing, testing, and committing changes
- When finished, fab rebases and merges their work to main (or opens a PR)
Components
| Component | Description |
|---|---|
| Architecture | High-level system overview, agent types, IPC protocol, and directory structure |
| Configuration | Global and per-project settings including API keys, backends, and merge strategies |
| Supervisor | Central daemon that handles CLI requests, manages orchestrators, and coordinates permissions |
| Orchestrator | Per-project lifecycle manager that spawns agents and coordinates merges |
| Issue Backends | Pluggable issue tracking: tk (file-based), GitHub Issues, or Linear |
| Permissions | Configure which agent actions are auto-approved, denied, or require manual review |
| TUI | Interactive Bubbletea-based interface for monitoring and managing fab agents |
Integrations
| Integration | Description |
|---|---|
| Claude Code | Default agent backend using Anthropic's Claude Code CLI with hook-based permission handling and bidirectional stdin communication |
| Codex CLI | Alternative agent backend using OpenAI's Codex CLI with event-based JSONL protocol and thread resume flow |
Quick Reference
Start the daemon and add a project:
fab server start
fab project add /path/to/repo --name myproject
Start orchestration and watch agents work:
fab project start myproject
fab tui
See the Getting Started guide for installation and the README for full CLI reference.