Install
pi install npm:platypus-pi
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.2.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.
- 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.
- 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 platypus_inspect_sessionplatypus_inspect_toolsetsplatypus_inspect_statusplatypus_inspect_work_queueplatypus_inspect_queue_statusplatypus_init_projectplatypus_list_backlogplatypus_validate_backlogplatypus_get_backlog_itemplatypus_create_backlog_itemplatypus_create_backlog_itemsplatypus_update_backlog_itemplatypus_write_task_planplatypus_validate_task_planplatypus_inspect_task_planplatypus_list_task_plansplatypus_prepare_workplatypus_complete_backlog_itemplatypus_dispatch_ready_workplatypus_finish_workplatypus_inspect_integration_gatesplatypus_integrate_worker_resultplatypus_record_evidenceplatypus_record_findingplatypus_list_findingsplatypus_validate_findingsplatypus_update_finding_dispositionplatypus_events_replayplatypus_doctor_snapshotplatypus_inspect_workflow_configplatypus_call_tool
Events subscribed before_agent_startsession_shutdownsession_starttool_result
APIs called execexec.stderr.trimexec.stdout.trimisIdleregisterCommandregisterShortcutregisterToolsendUserMessageui.addAutocompleteProviderui.notifyui.setStatusui.setWidgetui.theme.fg
3 calls the source scan did not predict
exec.stderr.trim · exec.stdout.trim · ui.theme.fg
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.2.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 Bridges
- pi-roam — Post-hoc handoff of a live Pi session into tmux for remote continuation, with optional Tai…
- pi-tldraw — Pi extension that opens and persists a local tldraw MCP canvas.
- @qianhuan-lxs/pi-mcp-bridge — Pi Agent extension that bridges MCP servers to the LLM via two dynamic-context tools (Call…
- pi-codegraph-extension — CodeGraph MCP tools for the Pi Coding Agent — semantic code search, impact analysis, call …