Cleveland-RD/hivehouse
37 stars · Last commit 2026-10-15
An agent hub for Claude Code: one hub runs teams of Claude Code agents across all your projects, with delegate mode, reviews and gates.
README preview
# hivehouse A Claude Code plugin that runs a software task with a team of Claude sessions in tmux: an orchestrator, the agents the task needs, reviews and gates before anything lands, context rotation, unattended overnight runs, and cleanup afterwards. A hub session in your work folder hands each task to its project's orchestrator and carries your words both ways. https://github.com/user-attachments/assets/4d7cd596-8090-4e91-b258-3f470838e277 Skills are instructions; every mechanical action is a tested bash executable in `bin/`. Ask Claude to customise anything: roles, rules, skills' behaviour, options. The one exception is loosening delegate (away) mode, which takes one sudo paste from you. See [Customise hivehouse](docs/customise.md#customise-hivehouse). ## Delegate mode The default is relay mode: every start, wake and answer waits for you. Delegate mode is the mode the hub runs while you are away: it decides internal work inside your projects and keeps the teams running, and it keeps pushes, deploys and spending for you. It is on only while a file only you can write says so, for at most 7 days. Details, and what it guards and does not, are in [Delegate mode (away)](docs/away-mode.md#delegate-mode-away); what you can allow it to do is in [Customising what away mode allows](docs/away-mode.md#customising-what-away-mode-allows). ## What hivehouse runs and sends hivehouse is bash scripts and a few hooks. One of them, `hooks/hub.tsx`, draws the hub's screen. Its `hub_auto_start` option is on by default: a plain `claude` started in the hub's folder then renames its session to hub and opens the hub, which takes one model turn. Apart from the push and the ssh below, it makes no network calls of its own, and it sends nothing to us. (The Claude sessions it starts talk to Anthropic like any Claude Code session.) This is everything it does outside its own files: - **It starts Claude sessions in tmux and types into their panes.** Only into panes it started or recorded as part of a team. It waits until the pane is idle and never types over a dialog. It types the first line of a started or woken session, `/clear` and the pickup line after a context rotation, and the keys for the option you chose in a Claude Code dialog (a digit, Escape, or arrows and Enter). It answers a dialog only after you chose, and never in delegate mode. - **Git worktrees and cleanup.** A team agent can get its own git worktree and branch in your repository. Cleanup removes only what its manifest recorded: temporary folders, files it moves to `.hivehouse/trash`, and the processes and panes it started.