pi-guard-sandbox
A lightweight OS-level guard for Pi: agents stay useful, sensitive paths stay blocked, and writes stay inside the workspace you allow. No container overhead. No workflow drama.
Install
pi install npm:pi-guard-sandbox
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.0.
This describes access, not safety — you decide whether it's appropriate for what
the package claims to do.
- 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.
- 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.
Events subscribed session_shutdownsession_starttool_call
Run against version 0.3.0 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 Guards & policy
- @yevhen.b/pi-preflight — Tool-call approvals and policy rules for Pi.
- pi-thegreataxios-staples — Personal staple extension for pi coding-agent — protected paths
- @tangle-network/tcloud-agent — Agent run-loop primitive over Tangle sandbox transports — runs an AgentProfile against a b…
- @yoseph_23/implannotator — Approval-gated frontend implementation for Pi, combining Implannotator design guidance wit…