All shelves / Mods / Workflow
swarm
By OneWave-AI
swarm is a Claude Code workflow mod by OneWave-AI.
Draws a live pane of your subagents: who spawned whom, how they overlap, and the messages between them.
Draws
Install
The marketplace name is claude-code-mods.
/plugin marketplace add OneWave-AI/claude-code-mods /plugin install swarm@claude-code-mods
It runs inside the Claude Code process. The side panel is only what the author's README names. Read the repo before you install, or run claude plugin validate on the plugin folder.
- Version
- 0.1.0
- License
- MIT
- Repo stars
- 17
- Last change
- 2026-10-03
What it can reach
- Draws in the session
- Sees tool calls
Needs Claude Code 2.1.287 or later. /swarm opens the pane. A status line shows the live count while agents run, and a toast sums the swarm when it stands down. It reads agent state only: spawns, tool calls, and messages between agents. It makes no network call, runs no process, reads no file, and calls no model.
The install name is swarm. This page adds the author's name. The marketplace name is claude-code-mods, the same string hamzafer, arasovic, and karanb192 use. The orchestration pane is why this page files it under workflow. agent-flow-luucas42 draws the main model, an advisor, and every subagent as cards joined by arrows in a side pane, plus every Claude Code session on this machine. turn-timeline draws the current turn as a timeline: one lane for the main loop, one per subagent, the split between model, tools, and idle, and the three slowest steps. This one draws who spawned whom, how the agents overlap, and the messages between them, in one pane.
Demo

What it hooks into
session.startWhen a session startscommand.runWhen you run its slash command/swarmagent.spawnWhen a subagent startstool.callAround a tool call, where it can hold onesession.sendA Claude Code eventsession.receiveA Claude Code eventturn.completeWhen a turn endsui.renderDraws into the sessionPane
Read from the on() calls in its hook modules. Open its source under Files to check what each one does.
Slash commands 1
/swarmSwarm: live map of subagents and agent teams, who is doing what, who spawned whom, who is talking
Files
The author's README and source, 4 files. They load when you open them.
Facts
- Author
- OneWave-AI
- Category
- Workflow
- Marketplace
- claude-code-mods
- Folder
- swarm
- Version
- 0.1.0
- License
- MIT
- Repo stars
- 17
- Last change
- 2026-10-03
- Language
- TypeScript
- Files
- 11