Charlie0113-T/claude-agent-flow

8 stars · Last commit 2026-10-05

agent-flow: a live tree of the session's subagents beside the transcript, as a Claude Code mod (/flow)

README preview

> **Note:** I'm still a student, so I may not be able to respond to issues or ship updates right away. I'll keep maintaining this plugin in my spare time as best I can.

# agent-flow

The agent flow pane as a plugin: `/flow` opens a live tree of the session's
subagents and in-process teammates beside the transcript, and closes it
again. Each row is one agent: status, type, name, description, elapsed time,
what it is doing right now (a tool call and how long it has run, or a wait
for the person's approval), its call count, and its tokens once it finished.
A `[+]` on a row expands its details: model, prompt excerpt, recent tool
calls, tokens. Agents waiting for approval are highlighted; a tool call over
30 seconds and a running agent silent for two minutes are marked too. A wait
for approval stays shown until the approved tool call ends, since no engine
event carries the person's answer.

The tree comes from engine events (`agent.spawn`, `tool.call`,
`turn.complete`, the classic permission events) and is reconciled with
`$.agent.list()` every two seconds while anything runs. Loops the engine
never listed (a Workflow tool's agents, the engine's own forks) appear under
a collapsed "unlisted loops" group so they never vanish silently.

View full repository on GitHub →