From thrum
Coordinates AI agents via Git-backed messaging, groups, and shared context. Use for communication, task delegation, or coordination across worktrees.
npx claudepluginhub leonletto/thrum --plugin thrumThis skill is limited to using the following tools:
Run `thrum prime` for full session context (auto-injected by hooks on
Coordinates multiple Claude Code instances as agent teams for workflows needing inter-agent communication. Covers TeamCreate, SendMessage types, task coordination, hooks, and orchestration patterns.
Orchestrates Claude Code agent teams for parallel multi-agent workflows on complex tasks using TeamCreate, SendMessage, TaskUpdate, and shared task lists. Enable with --enable-teams flag.
Coordinates multiple Claude Code sessions as lead + teammates with shared tasks, messaging, file locks for parallel repo development. Includes sizing, decomposition patterns.
Share bugs, ideas, or general feedback.
Run thrum prime for full session context (auto-injected by hooks on
SessionStart and PreCompact).
thrum send "msg" --to @name Direct message
thrum send "msg" --to @everyone Broadcast to all agents
thrum reply <msg-id> "response" Reply (same audience)
thrum inbox List messages (auto-marks displayed as read)
thrum inbox --unread Unread only (does not mark as read)
thrum sent List messages you sent
thrum sent --unread Sent messages with unread recipients
thrum message read --all Mark all messages as read
thrum wait Block until message arrives (30s timeout)
thrum wait --timeout 120s Custom timeout (duration)
thrum quickstart --name <agent-name> --role R --module M --intent "..." Register + start session
thrum whoami Show identity
thrum status Agent + daemon status
thrum team List active agents
thrum ping @name Check if agent online
thrum who-has <file> Who's editing a file
thrum group create <name> Create group
thrum group add <name> @agent Add agent to group
thrum group add <name> --role <role> Add all agents with role
thrum group list List groups
thrum send "msg" --to @group-name Message a group
thrum roles list List templates + matching agents
thrum roles deploy Re-render preambles from templates
thrum roles deploy --agent foo Deploy for specific agent
thrum roles deploy --dry-run Preview without writing
thrum session start Start session
thrum session end End session
thrum session set-intent "..." Update work description
thrum context prime Same as thrum prime
thrum context show Show saved work context
thrum context save --file <path> Save context from file
thrum overview Combined status + team + inbox
/thrum:update-context Guided context save (narrative + state)
/thrum:load-context Restore work context after compaction
thrum daemon start Start daemon
thrum daemon stop Stop daemon
thrum daemon status Daemon health
thrum sync force Force immediate sync
thrum sync status Sync state
thrum init Initialize thrum in repo (also starts the daemon)
thrum prime Full session context
thrum prime --json Machine-readable output
thrum <cmd> --help Detailed command usage
| Thrum | TaskList/SendMessage | Neither |
|---|---|---|
| Cross-worktree messaging | Same-session task tracking | Single-agent, no coordination |
| Persistent messages (survive compaction) | Ephemeral task lists | Temporary scratch notes |
| Background listener pattern | Inline progress tracking | Simple linear execution |
| Multi-machine sync via git | Local to conversation | No persistence needed |
| Group messaging | Direct teammate DMs | No audience beyond self |
Decision test: "Do messages need to survive session restart or reach agents in other worktrees?" YES = Thrum.
Thrum + TaskList coexist: Use TaskList for immediate session work. Use Thrum for cross-session/cross-worktree coordination messages.
When thrum prime detects a Claude Code session with an active identity, it
outputs a ready-to-use listener spawn instruction. Launch it to monitor for
messages in the background (~90 min coverage, 6 cycles × 15 min):
Task(subagent_type: "message-listener", model: "haiku", run_in_background: true)
The listener calls thrum wait (blocking), then returns when messages arrive.
Re-arm after processing. See
LISTENER_PATTERN.md.
thrum prime gathers identity, team, inbox, git context, sync healththrum prime on session start/tmp backup before compaction/thrum:load-context to restore your work context.thrum/identities/| Resource | Content |
|---|---|
| BOUNDARIES.md | Thrum vs TaskList/SendMessage decision guide |
| MESSAGING.md | Protocol patterns, context management |
| ANTI_PATTERNS.md | Common mistakes and how to avoid them |
| LISTENER_PATTERN.md | Background message listener template |
| CLI_REFERENCE.md | Complete command syntax reference |
| GROUPS.md | Group management patterns |
| IDENTITY.md | Agent identity and multi-worktree patterns |
| WORKTREES.md | Multi-worktree coordination |
Run thrum <command> --help for any command's full usage.