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.
/plugin install flowstate --marketplace picatz/flowstateIt 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

What it hooks into
session.startWhen a session startsprompt.contextA Claude Code eventprompt.submitWhen you send a promptcommand.runWhen you run its slash command/flowstatetool.callAround a tool call, where it can hold oneBashturn.startWhen Claude starts a turnclassic.StopA Claude Code eventui.renderDraws into the sessionAbovePromptPanetool.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