packages / pi-perms
toolextension Guards & policy

pi-perms

Pi CLI extension — configurable permission policy from .agents/permissions.json and native agent configs

No reviews yet

Install

$ pi install npm:pi-perms

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.0. This describes access, not safety — you decide whether it's appropriate for what the package claims to do.

  • ⇄
    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.

What it actually did when run

observed

Loaded 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 tool_call

Run against version 2.1.0 on 2026-08-02. Registration-time behaviour under default settings; other configurations may differ.

▲ Review before you install. pi packages run with your full system permissions. Check the source, pin versions, and prefer authors you trust.

Reviews

0 published

Sign 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.