@nerisma/pi-agents
Specialized agent system for pi: task delegation, activation/deactivation, and system prompt injection via .md files.
Install
pi install npm:@nerisma/pi-agents
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.3.2.
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.
- LLM traffic — Sees raw model API traffic Reads or replaces provider requests, headers or responses — including your prompts.
- 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 delegateagent_validateagent_capabilitiesskill_validateskill_savesession_findsession_statssession_extract
Events subscribed before_agent_startbefore_provider_requestcontextsession_shutdownsession_start
APIs called registerCommandregisterShortcutregisterToolsendMessagesessionManager.getEntriesui.notify
Run against version 1.3.2 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 Modes & workflows
- pi-executor — Pi extension to run executor
- pi-gsd — Get Shit Done - Unofficial port of the renowned AI-native project-planning spec-driven too…
- @gonrocca/zero-pi-todo — zero-pi-todo — TODOs persistentes para pi, con tool, slash command y overlay aboveEditor.
- @siddr/pi-review — Interactive review mode extension for pi