gentle-pi
Turn pi into el Gentleman — a senior-architect development harness with SDD/OpenSpec workflows and subagents.
Install
pi install npm:gentle-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 2.1.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.
- Credentials — Handles your API keys Reads or passes provider credentials. Highest-trust capability there is.
- 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.
- Network — Talks to the internet Makes outbound network requests. Check the destinations are ones you expect.
- 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.
Replaces pi's built-in tools: read, bash, grep, edit, write.
Every use of those tools goes through this
package instead of pi.
Tools registered codegraphgentle_reviewreadbashgrepfindlseditwrite
Events subscribed before_agent_startinputsession_shutdownsession_starttool_calltool_result
APIs called getActiveTools.callgetActiveTools.call.someregisterCommandregisterFlagregisterToolsdk.getAgentDirui.inputui.input.trimui.notifyui.selectui.select.startsWithui.select.toJSON
6 calls the source scan did not predict
getActiveTools.call · getActiveTools.call.some · sdk.getAgentDir · ui.input.trim · ui.select.startsWith · ui.select.toJSON
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 2.1.2 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
- bigpowers — 73 agent skills synthesizing 17 years of software engineering discipline into a prescripti…