Pi Auto Approval

pi-auto-approval

English | 中文

pi-auto-approval is an automatic approval extension for Pi, inspired by Claude Code auto mode and Codex Auto-review.

It uses an AI classifier to approve low-risk tool calls. Risky, denied, failed, or uncertain actions fall back to human approval or are blocked by the selected mode.

Installation

Install from npm (recommended):

Install a pinned release:

Install only for the current project:

Reload Pi and enable the recommended mode:

Migrate from a GitHub installation

Pi treats GitHub and npm sources as different packages. Remove the GitHub installation before using the npm package so the extension is not loaded twice.

Before removing it, run /auto-approval status and back up the displayed config.jsonc if you want to keep custom settings. The default config path is inside the installed package and does not move automatically between package sources.

For a user installation:

For a project-local installation:

Start Pi again, restore the config to the new path shown by /auto-approval status if needed, then run /reload. The unpinned remove command also matches an installation pinned to a Git tag such as @v0.1.0.

GitHub installation remains available as an alternative:

Commands

/auto-approval is the only slash command. Type /auto-approval  with a trailing space to see available arguments.

Screenshot

/auto-approval argument completions expose the available modes and model selector directly in Pi.

Architecture

pi-auto-approval sits between Pi tool calls and the normal approval path:

- command layer registers /auto-approval and persists local config;
- routing layer fast-paths disabled, read-only, workspace-safe, and session-approved actions;
- classifier layer projects recent session context and asks the selected model for a…