ClaudeCodeMod

All shelves / Mods / Workflow

flowstate

By picatz

flowstate is a Claude Code workflow mod by picatz.

For Flowstate, a workflow language, draws a pane of runs, checks a Flowfile after an edit, and asks before a flow command that changes a server.

DrawsHolds a command

Install

The marketplace name is flowstate.

In Claude Code
/plugin install flowstate --marketplace picatz/flowstate
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
0.1.0
License
MIT
Repo stars
9
Last change
2026-10-13

What it can reach

  • Draws in the session
  • Holds a command
  • Reads this turn's file edits
  • Reaches the network or an outside service
  • Sees tool calls
  • Runs a command when you press
  • Calls another program on this machine

Flowstate is a typed workflow language. You write a Flowfile, rehearse it on this machine, and can run the same workflow on Temporal. This plugin is its Claude Code install. It needs flow on PATH. flow is the Flowstate command-line tool, installed with go install github.com/picatz/flowstate/cmd/flow@latest. After Claude edits a Flowfile it runs flow validate, tells the model what is wrong, and can show a status-line count. When the session's folder holds a Flowfile, or a prompt names one, it adds a short block to what Claude reads: up to 40 task names and up to 5 flow validate problems. With verifyBeforeDone on, a turn that edited a Flowfile and ran no passing flow validate or flow test is sent back once with a reminder to run the check. The status line stays empty unless something needs a person, and drawing it starts no process. /flowstate opens a pane of the newest runs and the Flowfiles touched this session. The run list comes from flow list only when a server answers. With none, the pane says so and stays on this machine. The default address is localhost:9233. A FLOWSTATE_ADDRESS, or an --address that names another host, sends that call to the named host. Pressing a run opens a card. When the run is waiting on a signal, Send only asks. Nothing is sent until you confirm. Confirm runs flow signal once. A confirmed press also leaves one line for Claude on the next prompt. Before a Bash command runs a flow verb that changes a server (run, signal, cancel, terminate, and schedule create, delete, pause, resume, or trigger), it asks, naming the verb and the address. Local verbs, including validate, fmt, lint, test, run local, tasks, compile, timeline, list, and graph, and --help, do not ask. It also refuses an edit that puts an apparent secret literal in a Flowfile and points at a secret reference instead. That refusal has no off switch. A setting turns the confirmation before a server-changing verb off. The secret check reads the file the edit leaves. The README says this is a safety net, not a sandbox: scripts, aliases, functions, obfuscated commands, and a Flowfile written through the shell are out of its reach. In auto mode, Claude Code's classifier can allow the ask without a person confirming. The README says to use a permission rule, or a mode where a person confirms every server action. flowBinary defaults to flow. validateOnEdit, guardServerActions, and verifyBeforeDone default to on. A checkout starts with claude --plugin-dir editors/claude-code.

The install line has no @suffix. The marketplace name is flowstate. Flowstate is the parent project, a typed workflow language rehearsed locally and runnable on Temporal. This folder is its Claude Code plugin. It also ships the flow MCP server, skills, and agents. Claude's own tool calls from a skill are not this mod's access. A flow command to localhost:9233 is the local program. The same command to another host is the network access, and it is not also listed as a local program. Confirm is the press. The ask before a server-changing verb, and the refusal of a secret written into a Flowfile, are the hold.

Demo

The Flowstate for Claude Code page on the author's GitHub
Screenshot of the author's GitHub page.

What it hooks into

  • session.startWhen a session starts
  • prompt.contextA Claude Code event
  • prompt.submitWhen you send a prompt
  • command.runWhen you run its slash command/flowstate
  • tool.callAround a tool call, where it can hold oneBash
  • turn.startWhen Claude starts a turn
  • classic.StopA Claude Code event
  • ui.renderDraws into the sessionAbovePromptPane
  • tool.checkA Claude Code eventBash

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

Slash commands 1

  • /flowstateShow the validation state of Flowfiles touched this session

Files

The author's README and source, 4 files. They load when you open them.

Facts

Author
picatz
Category
Workflow
Marketplace
flowstate
Repo
picatz/flowstate
Folder
editors/claude-code
Version
0.1.0
License
MIT
Repo stars
9
Last change
2026-10-13
Language
Go
Files
134

Other mods in Workflow

taxi-blackboxdevbrother2024Records Claude's tool calls like a taxi dashcam and opens the moments before an error or a refusal.taxi-navidevbrother2024Draws Claude's to-do list as a taxi route, with the current stop and a cue when the plan changes.mod-managermishgoldenbergDraws a pane to install, turn on or off, update, or remove each mod in the claude-mods set.recap-plusskanehiraDraws a recap above the prompt of what this session is for, where it stands, and what comes next.phase-runner-hudAyeJKFor Phase Runner, skills that build a product in phases, raises a toast when a run needs you, and /phase-status prints where the run is with no model call.followthrough-bandbayramannakovFor Followthrough, a ledger of checks that outlive the session, draws the checks due for this repo above the prompt.jaira-cockpitBeMuCaFor Jaira, a markdown kanban for agent work, draws the tickets waiting on you, and waits before a large prompt goes out on a cold cache.showrunner-modBendzaeFor Showrunner, a terminal manager for agent sessions, draws the task above the prompt and reports that session's status back.command-centerBioInfoFor Claudelicious, one operator's Claude Code cookbook, draws a pane of the session's intent, running jobs, and open questions.todo-barhoobnnDraws a progress bar of Claude's task list above the prompt: the task in progress, how long it has run, and what is next.ts-bandhoobnnDraws your Tailscale machines above the prompt: one mark while every node is online and direct, otherwise the relayed or offline ones.agent-watchice-lfernandesDraws each subagent's tokens and a stall toast, and the last tool calls, with a summary of the heaviest agent when they finish.
All 396 in Workflow