@flowrail/hook
v0.0.5
Published
FlowRail PreToolUse hook dispatcher for Claude Code (POC). Pre-write secret scan + LLM-backed code verifier; pre-bash supply-chain check via the FlowRail MCP server.
Downloads
573
Readme
@flowrail/hook
PreToolUse hook dispatcher invoked by Claude Code on every Write/Edit/MultiEdit and Bash call. Exposes two sub-commands:
flowrail-hook pre-write— reconstructs post-edit content (handles plain Write, Edit withreplace_all: false/true, and MultiEdit composition), runs a regex secret scan, and routes code files through the FlowRail server's MCPflowrail_verify_codetool against the active design review's guardrails.flowrail-hook pre-bash— inspectstool_input.command, runsnpm install --dry-runto resolve the tree on package-install patterns, and routes through MCPflowrail_check_dep_installfor the 4-signal supply-chain check.
Reads FLOWRAIL_MCP_URL (default http://localhost:8787) for the server base URL and FLOWRAIL_API_KEY for the bearer. The full install (@flowrail/init-poc) bakes the URL into the hook command line in .claude/settings.json (tracked, no credential), but it does NOT bake the bearer there — .claude/settings.json is committed, and the env-reference contract requires the API key to live only in the tester's shell env. The hook inherits FLOWRAIL_API_KEY from whatever shell launched Claude Code; if that shell didn't export it, MCP calls fail open against the local-dev fallback. Keep FLOWRAIL_API_KEY exported (e.g. via ~/.zshrc) so every Claude Code session inherits it.
You probably don't invoke this directly — @flowrail/init-poc writes the right .claude/settings.json entries for you.
Source + docs: https://github.com/anshumanbh/flowstate
POC, eval-only.
