ClaudeCodeMod

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.

In Claude Code
/plugin marketplace add OneWave-AI/claude-code-mods
/plugin install swarm@claude-code-mods
Open the repo

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

A sample of the pane: SWARM ORCHESTRATING, 3 live, 1 done, 1 failed, 48 calls, 5 parallel, a tree of Lead, researcher, Check sources, builder, tester, and a failed auditor, a timeline, three messages, and an activity feed.
From the author's repo.

What it hooks into

  • session.startWhen a session starts
  • command.runWhen you run its slash command/swarm
  • agent.spawnWhen a subagent starts
  • tool.callAround a tool call, where it can hold one
  • session.sendA Claude Code event
  • session.receiveA Claude Code event
  • turn.completeWhen a turn ends
  • ui.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
Repo
OneWave-AI/claude-code-mods
Folder
swarm
Version
0.1.0
License
MIT
Repo stars
17
Last change
2026-10-03
Language
TypeScript
Files
11

Other mods in Workflow

dispatch-boardHangghostDraws a board of the mission files you write, showing which session is done, running, or waiting on you.handoff-runnerHangghostLets a background session hand you a finished worktree branch, and fast-forwards it when you press the pane's run button.qa-guideaieo-productWhen Claude asks a question, opens a pane that explains why, what each option does, and which option it would pick.workflow-watchalonbaronFollows the session's newest Workflow run and draws each stage live in a pane, a band above the prompt, and the status line.aicqashfulcraDraws AICQ, Fulcra's agent-to-agent work: your agents, friends' agents, and the collaborations under way, and answers new messages in the mode you set.gh-accountVedantAndhaleRuns each git or gh step as the logged-in GitHub account that owns that repository or is in its organization, and counts them on the status line.lightningLightning-AIDraws a live progress bar above the prompt for each Lightning AI job, with skills for that cloud platform's GPU studios, batch jobs, and deployments.ccfnaniilujaKeeps planning in plan mode, checks work against the project spec, runs slices in parallel, and can draw the task, the board, and the waves.roadraven-hudShuffzordDraws a live pane of RoadRaven, a local desktop plan tree, with agents on each node, UAT you pass or fail, and a backlog you can start.bettercallgptinsta-fusionPuts this session on a voice call you talk on while Claude codes, and sends microphone audio and call text to Azure or OpenAI on your own key.allowlist-coachice-lfernandesCounts permission dialogs you answer and, after repeated approvals, offers that rule for the allow list, asking you before it writes.test-hudice-lfernandesDraws each test run on the status line, passing over total with a sparkline of failures, and a pane of the tests that failed.
All 396 in Workflow