Manage an installation

Start with npx agentapprove status. It shows the current configuration and which hooks or plugins are installed.

Pause and resume hooks

Run npx agentapprove disable to temporarily move installed hooks out of the active agent configuration. Run npx agentapprove enable to put them back. Your local Agent Approve state stays in place.

Repair or update

Run npx agentapprove install again. Select the affected integrations and complete the prompts. The installer updates managed hook or plugin entries while preserving unrelated agent configuration.

Installer 0.1.43 and later also preserve the account-synced values in the local configuration, such as Mobile Q&A, the approval timeout, and agent display names. Earlier versions dropped them on reinstall, which left the hooks on defaults until the next configuration sync.

Force a configuration sync

If hooks behave as if a setting were off after an update or reinstall, change any setting in the iOS app and change it back, then send one event or approval from the computer. The change timestamps the account configuration as newer, and the next event carries it to the computer. See the configuration reference.

Use npx agentapprove profiles when only the Hermes profile selection needs to change.

Restore backups

Run npx agentapprove restore to restore the original integration configuration saved before Agent Approve modified it. Read the preview before confirming because later changes to the same configuration file may also be affected.

Remove hooks but keep local state

Run the uninstall command when you want to remove Agent Approve hooks and plugins but keep the local Agent Approve directory for a later reinstall.

Remove local state too

The purge command removes hooks and plugins, then removes the local Agent Approve state. It asks for additional confirmation when encryption material is present. After that action, older encrypted events may no longer be readable from that computer's key material.

Use the less destructive command unless you are intentionally retiring the installation. Neither command should be used as a first troubleshooting step.

Account closure

Changes made from the iOS app do not update coding-agent configuration files on your development computers. Apple billing is also managed separately.

Read Subscription and account lifecycle before closing an account so you can handle the subscription and each connected computer in the correct order.