Troubleshooting
No approval appears on the phone
Check the setup mode, installed integration, account connection, and notification path.
Start by tracing one request in the hook debug log. It separates an agent-hook problem from an API, policy, account, or iPhone delivery problem.
Then work through these checks in order:
- Run
npx agentapprove statusand confirm you are using Approval Mode. - Confirm that the coding agent you are running appears in the installed integration list.
- Keep the iOS app open and send another low-risk test from a new interactive agent session.
- Confirm that the phone and development computer both have network access.
- Check whether an existing remembered rule handled the command without asking you.
- Run
npx agentapprove installif the integration is missing or its files need to be refreshed.
If events appear only while the app is open, check iOS notification permission for Agent Approve. If nothing appears, collect a safe support report and contact Support.