All agents

Agent Approve for Gemini CLI

Mobile approvals, push notifications, and shared guardrails for Gemini CLI from your phone

Gemini CLI logo
CLIHook integration

Agent Approve gives you centralized control over Gemini CLI from your phone. Approve or deny tool calls from your iPhone or Apple Watch, with push notifications so you know the moment Gemini needs input.

You get one shared set of guardrails, one activity history, and one approval workflow that works the same way across Gemini CLI, Cursor, Claude Code, Codex, OpenCode, OpenClaw, and Copilot.

Install Gemini CLI

Quick start

1

Download Agent Approve from the App Store and complete onboarding.

2

Run npx agentapprove on your machine and select Gemini CLI.

3

Scan the QR code to pair with your phone.

4

Start using Gemini CLI — tool approval requests arrive on your phone.

Install command

npx agentapprove

Agent Approve config: ~/.agentapprove/

Gemini CLI hook config: ~/.gemini/settings.json

agentapprovev0.1.12

Recommended configuration

  • •Enable yolo mode in Gemini CLI to let hooks handle all permission decisions. See the Gemini CLI policy engine for more granular options.

Capabilities

Approval requests
Follow-up commands
Voice input
Activity monitoring
Push notifications
MCP tool tracking

Good to know

1

Full lifecycle hooks – Gemini CLI hooks cover SessionStart, BeforeAgent, BeforeModel, AfterModel, BeforeTool, AfterTool, AfterAgent, Notification, and SessionEnd.

2

Follow-up commands – Supported through the AfterAgent hook: Agent Approve returns decision=deny with your phone reply as the next prompt.

3

Voice input – Dictate a follow-up from your phone or Apple Watch when Gemini finishes a step.

4

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.

5

Stay up to date – Run npx agentapprove again at any time to update hooks to the latest version.

Use cases

Step away from the terminal and approve sensitive Gemini CLI tool calls from your phone instead of leaving it fully in yolo mode.

Use the same deny rules (rm -rf, credential access) across Gemini CLI, Cursor, Claude Code, Codex, and all your other agents.

When Gemini completes a turn, send a follow-up instruction from your phone so it keeps working while you are away.

Monitor Gemini activity in the same history as the rest of your agents.

Questions about Gemini CLI

A few common questions about how Agent Approve fits alongside Gemini CLI.