@blackbelt-technology/pi-flows
Flow engine, dashboard, and orchestration extensions for pi
Install
pi install npm:@blackbelt-technology/pi-flows
Installs from npm into ~/.pi/agent/.
Add -l for project-local (.pi/). Manage with pi list / pi update / pi remove.
What this package can reach
Detected automatically from the source at
version 0.3.4.
This describes access, not safety — you decide whether it's appropriate for what
the package claims to do.
- Behavior — Changes how the agent thinks Modifies the system prompt, injects messages, or rewrites conversation context.
- Extension bus — Talks to other extensions Uses pi.events to emit or listen on a shared channel, so it can coordinate with — or be driven by — other installed extensions.
- Commands — Runs shell commands Spawns processes on your machine.
- Files — Reads files outside your project Touches paths beyond the working directory, such as your home folder.
- Intercepts tools — Can block or rewrite tool calls Subscribes to tool_call/tool_result/input. Can change a command after you approved the one displayed.
- Keystrokes — Reads raw terminal input Hooks ui.onTerminalInput, so it sees what you type. Legitimate for shortcut handling; the same access a keylogger needs.
- Tool control — Can switch pi's tools on and off Calls setActiveTools, so it can disable built-ins — including safety-relevant ones.
- New tools — Adds model-callable tools Gives the agent new abilities. Additive and visible, unlike an override.
- UI — Draws its own interface Renders widgets, footers, dialogs or full-screen views.
What it actually did when run
observedLoaded in a sandbox with no network, a read-only filesystem and a recording stand-in for pi's API. This is what it called — not what the source suggests it might.
Tools registered ask_userskill_readflow_agentsflow_writeflow_results
Events subscribed before_agent_startflow:abortflow:completeflow:delete-requestflow:get-agentsflow:get-session-entriesflow:get-spawn-contextflow:list-flowsflow:notifyflow:rediscoverflow:register-agent-extensionflow:register-agents-dirflow:register-cardflow:register-flows-dirflow:register-footer-segmentflow:register-gateflow:register-skills-dirflow:register-toolflow:register-workflowflow:runflow:set-edit-modeflow:set-summary-contextflow:summary-dismissedflow:summary-readyflow:toggle-autonomousflow:unregister-agents-dirflow:unregister-flows-dirmodel_selectprompt:set-bus-requestsession_starttool_resultturn_end
APIs called events.emitevents.ongetActiveToolsgetActiveTools.filterregisterCommandregisterShortcutregisterToolsetActiveToolsui.confirmui.notifyui.setFooter
2 calls the source scan did not predict
events.on · getActiveTools.filter
Reached through a value the scan could not follow — passed as an argument, stored on another object, or returned by a helper.
Run against version 0.3.4 on 2026-08-02.
Registration-time behaviour under default settings; other configurations may differ.
Reviews
0 publishedSign in with GitHub to write a review, reply, or vote.
No reviews yet — be the first.
More in Observability
- @pi-vault/pi-usage — Pi extension that tracks Pi usage across your sessions in one dashboard
- @runfusion/fusion — Fusion CLI: HTTP API server, daemon, dashboard launcher, and task tooling for the Fusion A…
- @tmustier/pi-usage-extension — Usage statistics dashboard for Pi sessions.
- @amaster.ai/pi-telemetry — Pi extension for runtime telemetry with Langfuse and OpenTelemetry exporters