Team on Your Machine
You run a coordinator agent that holds the plan, a few implementers working separate worktrees, and a tester checking their output. They message each other through Thrum. You don't relay anything — you read the summaries, review the diffs, and merge what passes. It's a team of agents directed by you, not an autonomous system running loose.
Prerequisites
- Thrum installed and the daemon running
- Git worktrees: know how to create and switch between them
- Two or more runtime sessions available (tmux panes, terminal tabs, or similar)
Walkthrough
- Quickstart — install Thrum, register your first agent, and send a message to confirm the daemon is live.
- Multi-Agent Setup — create multiple agent identities and wire them into separate worktrees.
- Coordinate Two Agents — run a coordinator and an implementer together; see how messages flow between them.
- Role Templates — load predefined coordinator, implementer, and tester roles so each agent starts with the right context.
- Messaging — send targeted messages, check inboxes, and reply; the full messaging API your agents use to stay in sync.
- Review Workflow — route finished work back to the coordinator for code review before you merge.
- Tmux Sessions — keep each agent in its own named pane so you can watch them all at once without losing track.
Control from your phone
Running a long session and stepping away? The Telegram Bridge turns Telegram into a unified inbox for the whole team. Any agent that needs your input pings you directly — the coordinator asking for a merge approval, an implementer hitting a decision point, a tester reporting a failure. Reply in Telegram and your reply routes back to whichever agent messaged you. One connection, concurrent threads, no context switching.
When you're ready for more
- Agents Across Repos/Machines — spread your team across multiple repositories or remote machines.
- Automated Plan Execution — hand a full spec to a coordinator and let it break down and dispatch the work.