Quickstart
Install Agent Approve, pair your iPhone, and connect your first coding agent.
You will run the Agent Approve installer on your development computer, pair it with the iOS app, and enable one or more supported coding agents.
Before you begin
You need:
- An iPhone with Agent Approve installed and signed in
- An active subscription or free trial
- A development computer with Node.js and
npx - At least one supported coding agent installed
Install and pair
-
Open Agent Approve on your iPhone.
-
On your development computer, run:
npx agentapprove -
Choose Recommended setup or Customize options. If you customize the setup, choose Approval Mode or Observe Mode and review the fallback, privacy, encryption, retention, and logging choices.
-
Select the coding agents you want to connect.
-
Choose the QR code pairing method.
-
In the iOS app, open the pairing scanner and scan the QR code shown in the terminal.
-
Confirm the computer shown by the app and finish the installer.
If you choose Recommended setup, the installer uses Approval Mode, end-to-end encryption, Ask for offline fallback, Full Content privacy, 30-day retention, and debug logging off.
The terminal reports that setup is complete and lists the installed integrations. Run npx agentapprove status to see the saved configuration.
Check the connection
Continue to Verify your setup. A successful installation is not the same as a tested approval path.
If the QR code expires, run npx agentapprove again and start a new pairing session.