agent-flow

Reviewed at commit 76ef8fb

/flow opens a live tree of the session's subagents and teammates beside the transcript.

Made by
Charles Tao
What we checked

Adds a /flow pane beside the transcript that shows a live tree of the session's subagents and teammates, what each is doing, how long it has run, token counts and which are waiting for approval. Expanding an agent now also shows the tail of its streamed text. It keeps everything in memory, makes no network calls and only remembers whether the pane was open.

Review details

Static review of the source at the pinned commit; not run. Registers session.start, ui.render (PromptHint, Pane), command.run (/flow, /flow text; also clear and resume to reset), ui.close, agent.spawn, tool.call, turn.step, turn.start, turn.complete, classic.PermissionRequest and classic.Notification (permission_prompt). All handlers only observe and call next unchanged; none block, rewrite or approve anything. It records agent ids, types, descriptions, the first 120 characters of each subagent spawn prompt, tool names with durations and error flags, token usage, and, new in this version, the newest 1500 characters of each subagent's streamed text for display in the pane. This stays in memory for at most 200 nodes. Runtime calls: $.agent.list (every 2 seconds while agents run), $.clock, $.ui.open/close/invalidate/status/log/resolve, $.command.register, and $.store for one boolean (pane kept open). No network, no file access, no process execution, no environment reads. Dev scripts (scripts/*.sh, *.exp) and the bun test helpers are not loaded by the mod. No npm dependencies.

What it uses
  • Reads your prompts: no
  • Sees tool calls: yes
  • Blocks or changes tool calls: no
  • Reads or writes files: no
  • Runs programs on your machine: no
  • Calls the model (uses tokens): no
  • Sends data over the network: no
  • Stores data: yes
  • Shows something on screen: yes
Hooked events

The agent flow pane: /flow opens a live tree of the session's subagents and teammates beside the transcript, fed by engine events, with a text fallback where no pane can be drawn.

Made this mod? Add a badge to your README

modsforClaude badge for agent-flow

Paste this into your README. The badge says reviewed once the current version has been reviewed, and links readers to this page.

[![Listed on modsforClaude](https://modsforclaude.com/badge/agent-flow.svg)](https://modsforclaude.com/mods/agent-flow/)

← All mods