Claude: Visualize Agents Swarms

A short note on claude-agent-map: a Claude Desktop pane that shows the main session and every subagent — tier, time, tokens, and tasks — so parallel agent runs stay readable.

Superlite will happily put a dozen agents to work at once. That is the point. It is also the problem.

When the build is going well, the transcript is a waterfall of launches, reviews, and checkpoints. When it is not, you need to know which agent stalled, which task it owned, and whether the coordinator is still thinking or just waiting. Grepping progress.md and metrics.jsonl works. It does not feel like watching the run.

So I split out claude-agent-map: a small Claude Desktop plugin that opens a read-only Agent map pane beside the transcript.

It shows the main session at the top, and every subagent under the agent that spawned it. For each one you get:

The pane only reads. It never steers a run.

Open it with /claude-agent-map, optionally pointing at a project (or its .superlite folder). You can also ask Claude to open it, or reply approve map when superlite offers the pane at plan approval. Installing superlite from the marketplace pulls this plugin in as a dependency.

Parallel agent workflows fail quietly in the UI long before they fail in the tests. Eighteen agents is not “visibility.” It is a pile of IDs. The map turns that pile into a picture: who spawned whom, which tasks are still open, and which nodes went red.

Just enough structure that you can leave a swarm running and still answer “what is happening right now?” without opening six files.

The repo is here: https://github.com/iha2/claude-agent-map.