ClaudeCodeMod

All shelves / Mods / Workflow

flowctl

By MarcoFilho1

flowctl is a Claude Code workflow mod by MarcoFilho1.

Draws Claude Code's plan as a live graph in FlowCTL, a floating window: what is running, what comes next, and when a step needs you.

Draws

Install

The marketplace name is flowctl.

In Claude Code
/plugin install flowctl --marketplace MarcoFilho1/FlowCTL
/flowctl init
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
1.0.9
License
MIT
Repo stars
7
Last change
2026-10-16

What it can reach

  • Draws in the session
  • Reaches the network or an outside service
  • Sees tool calls
  • Calls another program on this machine

FlowCTL is a floating window on macOS or Windows, plus this plugin. The plugin watches the session and builds the graph. The app draws it. The graph is the agent's plan: one node per step, what is running, what comes next, and when a step needs you. It observes task tools, subagents, permission checks, and tool errors. A tool error flashes the step red. Repeated errors keep it red. A permission prompt or a question turns the step yellow. Clicking a node brings that terminal forward. When a session starts, the plugin opens the overlay if it is installed. Several sessions share one window, one page each. The latest graph per session stays in ~/.flowctl/sessions. The plugin hands the app each graph over a local socket, ~/.flowctl/overlay.sock, or on Windows 127.0.0.1 with a token from ~/.flowctl/overlay.json. The README says everything stays on your computer. A graph holds step titles, statuses, times, a short summary, and the first line of a tool error. The README says it never holds your prompts, file contents, or full command output. The only network call is /flowctl init downloading the app from this repository's GitHub Releases, and the same download updates the app. Open the overlay when a session starts is on by default. Update the overlay is on by default. Asking the agent to declare its plan is on by default, and you can turn that request off in the plugin's options. Without it, the graph is usually one node. Errors before red defaults to 3. Record events is off by default, and writes ~/.flowctl/recordings only when you turn it on. Hide when idle and the idle animation are on by default. Needs macOS 13 or later, or Windows 10 or 11 64-bit, and Claude Code 2.1.295 or later. Answer y to add the marketplace, and choose the user scope so it works in every project. The README says the plugin never changes what the agent does, apart from that optional request to declare a plan.

The plugin folder has no README. These lines are the repository README. The install line has no @suffix. /flowctl init is the second install line. The marketplace name is flowctl. The plan graph, what is running and what comes next, is why this page files it under workflow. The overlay app and the local socket are the local program. The download from GitHub Releases is the network access, and that is where /flowctl init goes. The plan request is added to the prompt, and it starts on.

Demo

From the author's repo.

What it hooks into

  • session.startWhen a session starts
  • command.runWhen you run its slash command/flowctl
  • session.endWhen a session ends
  • prompt.submitWhen you send a prompt
  • prompt.composeWhile you write a prompt
  • turn.startWhen Claude starts a turn
  • turn.completeWhen a turn ends
  • tool.callAround a tool call, where it can hold one
  • tool.checkA Claude Code event
  • agent.spawnWhen a subagent starts
  • classic.*A Claude Code event

Read from the on() calls in its hook modules. Open its source under Files to check what each one does.

Slash commands 1

  • /flowctlInstall, update or remove the FlowCTL overlay app

Files

The author's source, 3 files. They load when you open them.

Facts

Author
MarcoFilho1
Category
Workflow
Marketplace
flowctl
Repo
MarcoFilho1/FlowCTL
Folder
mod
Version
1.0.9
License
MIT
Repo stars
7
Last change
2026-10-16
Language
TypeScript
Files
21

Other mods in Workflow

panelinemarkneoninDraws a side pane of activity, files, agents, context, MCP, skills, and spend, plus a status line and a restyled chat.jev-searchmukiwuAnswers Claude Code's WebSearch with Jev Search, and sends each query to your Jev Search instance, jev.s1.dev unless you change it.flow-progresstassosgomesDraws a band above the prompt with TSG Flow's tasks done and its current phase. One mod inside my-skills.whats-agent-doingtzafrirDraws a box above the prompt that names the step Claude is on, how long it has lasted, and each background agent.allthingsallthingsweb-devRewrites each tool row as a verb, a slash, and its target, and draws the next allthings evening above the prompt, fetched from allthings.dev.agent-crewbekir1184Draws your subagents above the prompt as a pixel-art crew, with the current work, progress, time left, and tokens.typesafe-modBeLazy167Holds a commandWhen Claude asks you a this-or-that question, sends it to TypeSafe's Jev and draws the odds of each option beside the dialog.keel-progressberkayturanciDraws each live keel run above the prompt and in a side pane, read from keel status and the run's activity file.squad-chatchrisluo5311Opens a pane to chat with friends on your squad's own Supabase, plus rooms for usage, git, and every session's subagents.agent-monitorGarvitNangruDraws a progress bar above the prompt as each plan step finishes, and a panel of the plan and every subagent's model, context, and cost.rllvmh1994stFor rllvm, which pulls LLVM bitcode out of a build, draws a read-only pane of the call-graph overlay. Skills and a query server come in the same install.goblin-utilJasonWarrenUKDraws a /fleet pane of every Claude Code session on this machine and sends a message to the one you pick. The same install's /pain logs friction.
All 396 in Workflow