Docs
Shelbi is an agent orchestrator for the terminal — a board of tasks, a pool of git workspaces, and an orchestrator that keeps them loaded with work. These docs take you from install to a running loop, then explain the pieces and the CLI behind it.
Start hereGetting StartedThe shortest path from an empty machine to the loop running on your own repo — install the binary, set up a project, run a task, scale to a pool of workspaces, and hand the loop to the orchestrator.Start the guideGuides
Understanding WorkflowsMap a git branching model — trunk-based, git-flow, feature-branch, or forking — onto a Shelbi Workflow: the statuses, transitions, and orchestrator tweaks for each.WorkflowsThe fundamentals every other guide builds on — what a Workflow is, how statuses and git side-effects fit together, and why it's the unit you configure per project.
Concepts
- OrchestratorThe agent you talk to — it dispatches tasks and tails the events log.
- WorkspacesCapacity: a tmux pane plus a git worktree the orchestrator loads with work.
- AgentsA role — system prompt plus skills. Shelbi ships three; you can author more.
- Zen ModeHands-off auto-merge — cleared work lands without waiting on you.
CLI Reference
- shelbi taskAdd, list, move, assign, and start tasks on the board.
- shelbi workspaceInspect the workspace pool and stop a pane to free a stuck task.
- shelbi workflowList, show, scaffold, and edit the per-project workflow YAML.
- shelbi mergeMerge a workspace branch into the default branch, locally or via PR.
Reading with an agent
Every page is available as clean markdown — append .md to any docs URL. Hand the whole corpus to a coding agent, or grab a ready-made prompt.