Getting Started

Installation

With Go

go install github.com/tessro/fab/cmd/fab@latest

From Source

git clone https://github.com/tessro/fab
cd fab
go build -o fab ./cmd/fab

Quick Start

1. Start the daemon

fab server start

2. Add a project

# From a local path
fab project add /path/to/your/project --name myproject --max-agents 3

# Or from a git URL
fab project add git@github.com:user/repo.git --name myproject

3. Configure permissions (optional)

Enable autonomous mode with LLM-based authorization:

fab project config set myproject permissions-checker llm

4. Start orchestration

fab project start myproject

5. Watch the magic happen

fab tui

Kick back while the TUI shows all running agents claiming tasks and shipping code. Grab a snack, you've earned it.

Configuration

Global config lives at ~/.config/fab/config.toml:

# Logging level: debug, info, warn, error
log-level = "info"

# API Provider Configuration
[providers.anthropic]
api-key = "sk-ant-..."  # Or use ANTHROPIC_API_KEY env var

# LLM Authorization Settings
[llm-auth]
provider = "anthropic"
model = "claude-haiku-4-5"

For full configuration options, see the Configuration documentation.

Issue Backends

fab can pull tasks from different issue tracking systems:

GitHub Issues

fab project config set myproject issue-backend gh

tk (ticket)

fab project config set myproject issue-backend tk

For more details on issue backends, see the Issue Backends documentation.

Verification

Verify your installation:

$ fab version
fab version v0.x.x

Check that the daemon is running:

$ fab status
Daemon: running

List registered projects:

$ fab project list
NAME       STATUS    AGENTS
myproject  running   2/3

Examples

Adding a project from a local path

fab project add /path/to/local/repo --name myproject

Setting up GitHub Issues backend

fab project config set myproject issue-backend gh
fab project start myproject

Viewing agent activity

fab agent list
fab tui

Next Steps