Docs
Guides and reference for Shelbi.
Concepts
- WorkersA worker is a long-lived agent slot pinned to a machine and a worktree — the unit the orchestrator dispatches tasks to.
- ColumnsThe five-column Kanban board — how tasks move through backlog, todo, in_progress, review, and done.
- The events logAn append-only file at ~/.shelbi/events.log — every worker state change and task column move, in one stream the orchestrator tails.
- The orchestratorOne agent in window 1 you talk to — it dispatches tasks to workers, tails the events log, and reports back. You are the priority-setter; it is the scheduler.
Getting Started
Cli
- shelbi taskManage the project's Kanban task board — add, list, move, assign, and start tasks from the CLI.
- shelbi workerInspect and control the project's declared worker pool — list slots, kill panes, read observed state.
- shelbi reviewCheck a task's branch into the review work_dir and (re)launch a fresh review-claude pane there.
- shelbi eventsInspect the hub-global worker-state transition log — the same feed the orchestrator reacts to.
- shelbi mergeMerge a worker's branch into the project's default branch, locally or via a GitHub PR.
- shelbi reloadRespawn the Shelbi-owned tmux panes in place so a freshly installed binary takes effect.