Quickstart
Connect your AI agent and your phone in one command
One command connects your agent and your phone. It detects Claude Code, Codex, Cursor, and Hermes, writes their config, saves your API key, and walks you through connecting your phone so you can receive notifications.
Before you begin
- An AI agent installed (Claude Code, Codex, Cursor, Hermes, Windsurf, or any MCP client)
- Your phone, to receive notifications and approve actions
- A Pushary API key. See Get your API key.
Get your API key
When you sign up, Pushary creates your first API key for you. Copy it from your settings page when you need it:
pushary.com/dashboard/agent/settings
A key looks like pk_... followed by a dot and a long secret. Treat it like a password. Full details: Get your API key.
Run the setup command
npx @pushary/agent-hooks@latest setupIt checks which agents you have installed, asks which ones to connect, saves your API key, and configures each agent. When prompted, paste the key from your settings page.
Connect your phone
The CLI shows a QR code. Scan it with your phone camera, then tap Allow when your browser asks for notification permission.
On iPhone, add the page to your Home Screen first, then open it from the Home Screen and allow notifications. The CLI waits until your phone is connected, sends a test push, and confirms it arrived.
Verify everything works
npx @pushary/agent-hooks@latest doctorThis checks the MCP connection, sends a test notification, and can run a full question and answer round trip to your phone.
Try a real approval
Restart your agent, then ask it to do something that needs your sign-off:
Before you delete anything, ask me via Pushary if it is OK.Your phone shows the question with Yes and No. Tap your answer and the agent continues.
One command, no paste (coming soon)
If you have the Pushary mobile app, this single command mints your key, seals it to the CLI, and pairs the app, with nothing to copy or paste:
npx @pushary/agent-hooks@latest setup --connect appYou open the app, tap Connect agent, scan the QR, and confirm the fingerprint the CLI shows. The native app is currently in internal testing. See Receiving notifications.
Other useful flags
# Pass an existing key without the paste prompt
npx @pushary/agent-hooks@latest setup --key pk_xxx.xxx
# Skip the phone step (CI or non-interactive shells); prints the link instead
npx @pushary/agent-hooks@latest setup --skip-phoneSee the CLI reference for every command and flag.
Not using one of the detected agents? See Supported agents for the full list, or Connect any agent for the MCP and REST options.