Agent Approve for Pi
Mobile approvals, shared guardrails, and activity monitoring for Pi from your phone
Agent Approve gives you centralized control over Pi from your phone. Approve or deny shell commands, file changes, search/read/edit operations, network calls, and MCP tools from your iPhone or Apple Watch, with push notifications so you know when Pi needs a decision.
You get one shared set of guardrails, one activity history, and one approval workflow that works the same way across Pi, Cursor, Claude Code, Gemini CLI, Codex, OpenCode, OpenClaw, and Copilot.
Pi activity stays visible after the approval: responses, thinking blocks, plans, and tool results appear in your history, and you can send a follow-up prompt from your phone when Pi completes a turn.
Quick start
Download Agent Approve from the App Store and complete onboarding.
Run npx agentapprove on your machine and select Pi.
The installer runs pi install npm:@agentapprove/pi@0.1.5 automatically.
Scan the QR code to pair, then restart Pi.
Install command
npx agentapproveAgent Approve config: ~/.agentapprove/
Pi hook config: ~/.pi/agent/settings.json
Recommended configuration
- •The installer adds the
@agentapprove/piplugin through Pi's package manager automatically. - •Restart Pi after installation so the plugin can start sending approvals and activity to Agent Approve.
Capabilities
Good to know
Plugin-based integration – The installer runs pi install npm:@agentapprove/pi to add the plugin through Pi's package manager.
MCP visibility – Pi MCP tools are grouped under their server names so you can use the same allow and deny lists you use for Cursor and other agents.
Activity history – Pi responses, thinking blocks, plans, and tool results appear alongside your other agent activity.
Follow-up prompts – When Pi completes a turn, you can send the next instruction from your phone by text or voice.
Bulk command parsing – Policy evaluation parses shell commands chained with && into individual sub-commands evaluated independently. A dangerous command like rm -rf hidden as the third step in a chain is caught even when the batch starts with safe commands.
Stay up to date – Run npx agentapprove again at any time to update the Pi plugin to the latest version.
Use cases
Step away from the terminal and approve Pi tool calls from your iPhone or Apple Watch.
Use the same deny rules for Pi that you already use across Cursor, Claude Code, Codex, and your other agents.
Track Pi responses, plans, thinking blocks, and tool results in one shared activity history.
Send a follow-up prompt from your phone when Pi completes a turn.
Questions about Pi
A few common questions about how Agent Approve fits alongside Pi.