All shelves / Mods / Workflow
agent-flow
By luucas42
agent-flow is a Claude Code workflow mod by 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.
Draws
Install
The marketplace name is agent-flow.
/plugin install agent-flow --marketplace luucas42/agent-flowIt 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.5.0
- License
- MIT
- Repo stars
- 6
- Last change
- 2026-10-12
What it can reach
- Draws in the session
- Reads usage or context figures
- Sees tool calls
- Calls another program on this machine
The panel opens by itself when a session starts. In the fullscreen terminal it docks on the right. Otherwise it sits inline above the prompt. A pane opened at session start needs at least 144 columns. After /flow once, it opens itself from 110 columns. A card shows the effort, what that agent is doing, its token total, and a sparkline. Click a card, or its digit, to open that type's rows. A row shows the task, the current tool and target, and tools, tokens, and time. The strip shows the session cost, how long it has run, how many agents are live, and the token count. Dollars appear only as the session total. Agent cost is tokens. The sessions table lists every Claude Code session on this machine: the tool it has open while it works, or the first line of its last answer while it waits. The table reads ~/.claude/sessions/*.json and the last 256 KB of each transcript, and checks with ps that the process is still claude. The author says nothing leaves the machine. notifications defaults to batch-and-errors. every-agent also toasts each finish. errors is failures and refusals. off is none. sound defaults to on, a short tone on macOS. Your own session never toasts. The author says the mod never blocks a tool call. Built and tested on 2.1.294.
The install name is agent-flow. This page adds the author's name. The install line has no @suffix. The marketplace name is agent-flow. The cards of agents, joined by arrows, are why this page files it under workflow. agentpane draws a side pane of every subagent, with its current tool, tokens, model, and effort, and its conversation one click away. agent-crew draws your subagents above the prompt as a pixel-art crew, with the current work, progress, time left, and tokens. This panel is the cards and the arrows, plus every session on the machine.
Demo

What it hooks into
session.startWhen a session startsclassic.UserPromptSubmitA Claude Code eventclassic.StopA Claude Code eventturn.startWhen Claude starts a turnturn.stepAt each step of a turnagent.spawnWhen a subagent startstool.callAround a tool call, where it can hold oneturn.completeWhen a turn endssession.endWhen a session endscommand.runWhen you run its slash commandui.renderDraws into the sessionPaneui.messageAdds a message to the session
Read from the on() calls in its hook modules. Open its source under Files to check what each one does.
Files
The author's README and source, 4 files. They load when you open them.
Facts
- Author
- luucas42
- Category
- Workflow
- Marketplace
- agent-flow
- Version
- 0.5.0
- License
- MIT
- Repo stars
- 6
- Last change
- 2026-10-12
- Language
- TypeScript
- Files
- 30