@piagent/platform
Reusable Pi agent platform, project adapters, MCP/tool policy, and coding workflow harness.
Install
pi install npm:@piagent/platform
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 1.2.10.
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.
- Subagents — Spawns agents or sessions Runs additional agents. Ask whether it caps iterations and spend.
- 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 piagent_toolspiagent_context_enginepiagent_contextpiagent_permission_statuspiagent_exec_policy_checkpiagent_context_budgetpiagent_tool_policy_checkpiagent_task_gate_checkpiagent_usage_snapshotpiagent_context_preflightpiagent_orchestration_policypiagent_memory_statuspiagent_memory_notepiagent_memory_searchpiagent_context_index_statuspiagent_context_index_searchpiagent_context_index_recordpiagent_profile_optionspiagent_profile_applypiagent_profile_tech_optionspiagent_profile_tech_applypiagent_profile_tech_context_recordpiagent_project_onboarding_recordpiagent_task_startpiagent_document_readpiagent_source_checkoutpiagent_context_recordpiagent_verify_recordpiagent_memory_citation_recordpiagent_trace_record
Events subscribed before_agent_startinputsession_compactsession_shutdownsession_starttool_calltool_resultturn_end
APIs called appendEntrygetActiveToolsgetContextUsagegetContextUsage.percent.toFixedgetThinkingLevelisProjectTrustednewSessionregisterCommandregisterToolsendMessagesendUserMessagesessionManager.getBranchsessionManager.getEntriessessionManager.getSessionFilesessionManager.getSessionIdsessionManager.getSessionNamesetSessionNameui.notify
1 call the source scan did not predict
getContextUsage.percent.toFixed
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 1.2.10 on 2026-08-01.
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 Guards & policy
- @spences10/pi-nopeek — Secret-safe workflow reminder that steers Pi agents to use nopeek instead of exposing .env…
- pi-mono-sentinel — Pi extension that guards against content-based secret leaks and indirect script execution
- pi-mono-context-guard — Pi extension that guards context window growth by auto-limiting read and rg output
- @diegopetrucci/pi-permission-gate — A pi extension that prompts before dangerous bash commands and protected file writes.