packages / pi-permission-gate
extension Guards & policy

pi-permission-gate

Config-driven permission system for Pi agents. Deny-by-default tool restriction with glob matching, path normalization, self-protection, and structured logging.

No reviews yet

Install

$ pi install npm:pi-permission-gate

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.1.5. 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.
  • 📁
    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.
  • 🔀
    Tool control — Can switch pi's tools on and off Calls setActiveTools, so it can disable built-ins — including safety-relevant ones.

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 before_agent_startsession_starttool_call

APIs called getAllToolsgetAllTools.mapgetAllTools.map.filtersetActiveTools

2 calls the source scan did not predict

getAllTools.map · getAllTools.map.filter

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 0.1.5 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