Getting started

Verify your setup

Check the saved configuration and confirm that a real agent request reaches Agent Approve.

Verify the full path before you depend on Agent Approve during unattended work.

Check the installer status

Run:

npx agentapprove status

Confirm that the expected mode and integrations appear. If an integration is missing, run npx agentapprove install and select it.

Send a low-risk test

  1. Keep Agent Approve open on your iPhone.
  2. Start a normal interactive session in one installed coding agent.
  3. Check the active policy. Restrictive Ask allows unmatched commands, so a harmless command may complete without asking you.
  4. In a policy that checks lists, add a temporary Ask List entry for a harmless test command that no Allow List entry already covers. For example, ask the agent to print a unique test phrase and match that phrase with Contains. Allow All and Deny All skip lists.
  5. Ask the agent to run that command. Confirm that the request appears in Agent Approve and identifies the Ask List match.
  6. Review the command and choose Approve or Deny. Confirm that the coding agent receives the same result.
  7. Remove the temporary Ask List entry when you finish.

Use a command that does not modify files or system state. Do not weaken a policy to force a test request.

If no request appears

Check that you are using Approval Mode, the integration is enabled, and the iPhone has a network connection. Then see No approval appears.

Go out and grab a coffee

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