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:

  1. Run npx agentapprove status and confirm you are using Approval Mode.
  2. Confirm that the coding agent you are running appears in the installed integration list.
  3. Keep the iOS app open and send another low-risk test from a new interactive agent session.
  4. Confirm that the phone and development computer both have network access.
  5. Check whether an existing remembered rule handled the command without asking you.
  6. Run npx agentapprove install if 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.

Go out and grab a coffee

We'll ping you if your agents need you. Try Agent Approve free for 7 days.