agentapprove
v0.1.4
Published
Approve AI agent actions from your iPhone or Apple Watch
Maintainers
Readme
Agent Approve
Monitor AI coding agents and approve commands from your iPhone or Apple Watch. Go out and enjoy life while your agents stay busy. We'll ping you.
AI coding agents like Claude Code, Cursor, and Gemini can write code, refactor files, run tests, and execute shell commands autonomously. But when they hit a permission boundary -- something sensitive that requires human approval -- they stop and wait. And so do you.
Agent Approve fixes this. When your agent needs approval, you get a push notification on your phone or watch. You see the command, tap to approve or deny, and your agent keeps working. When it finishes a task, you get notified and can issue a follow-up with voice input.
Set your policies, configure your privacy level, and let your agents run. We'll find you when they need you.
Installation
npx agentapproveOr install globally:
npm install -g agentapprove
agentapproveUsage
agentapprove # Install wizard (default)
agentapprove status # Show configuration
agentapprove pair # Pair with a new iOS device
agentapprove refresh # Refresh token and hooks
agentapprove disable # Temporarily disable hooks
agentapprove enable # Re-enable hooks
agentapprove uninstall # Remove hooks
agentapprove restore # Restore from backup
agentapprove help # Show helpOptions
agentapprove --no-e2e # Skip end-to-end encryption setupSupported AI Agents
- Claude Code - Anthropic's CLI for Claude
- Cursor - AI code editor
- Gemini CLI - Google's CLI
- VS Code Agent - VS Code agent hooks
- GitHub Copilot CLI - GitHub's coding agent
- OpenCode - Open-source AI coding agent
- OpenClaw - Open-source AI agent platform
- OpenAI Codex - coming soon
- And more
Features
- Approve on the go - Hooks send events through our cloud so you can monitor and approve while walking the dog or getting coffee
- Push notifications - Never miss an approval request. Avoid wasted idle time with your agents
- Apple Watch - One-tap approvals from your wrist. Review context and respond without reaching for your phone
- Voice commands - Send follow-up commands to your agents using the microphone when they finish a task
- Agent observability - Full visibility into what all your agents are doing, especially autonomous agents like OpenClaw or long-running loops (Ralph loops)
- Centralized policies - Set auto-approve and deny rules across all your agents from a single policy
- End-to-end encryption - You own the keys. Approval requests are encrypted on your machine and decrypted only on your device
- Privacy tiers - Choose minimal, summary, or full data logging. Control retention from 1 to 365 days
Installer Features
- Privacy tiers - Choose minimal, summary, or full data logging
- Data retention - Control how long event history is stored (1-365 days)
- QR code pairing - Scan to pair your iOS device
- macOS Keychain - Token stored securely in Keychain on macOS
- Automatic backups - Timestamped backups of all modified config files
- Hook preservation - Updates only Agent Approve hooks, preserves your other hooks
- Debug logging - Optional verbose logging to
~/.agentapprove/hook-debug.log - System dependency checking - Validates and optionally installs required tools
- Cross-platform - macOS, Linux, and Windows (via Git Bash)
How It Works
- Download Agent Approve from the App Store and start your 7-day free trial
- Follow the in-app onboarding, which prompts you to run
npx agentapproveon each machine - The installer pairs your device, sets up hooks, and configures your agents
- Approve or deny actions from your phone or watch
Requirements
- Node.js 18+
- macOS, Linux, or Windows (with Git Bash / Git for Windows)
- System tools:
curl,jq,openssl(included with Git Bash on Windows)
Links
License
Proprietary. Copyright (c) 2026 Agent Approve LLC. All rights reserved.
