Browse Docs

AI Agents

Step away from your desk while Claude Code works. When the task is done, you’ll get a push notification on your phone.

Claude Code

Install the API Alerts CLI and configure your API key once:

brew tap apialerts/tap
brew install --cask apialerts
apialerts config --key YOUR_API_KEY
scoop bucket add apialerts https://github.com/apialerts/scoop-bucket
scoop install apialerts
apialerts config --key YOUR_API_KEY

Ask Claude to notify you

Because the CLI is installed on your machine, Claude Code can run it directly as part of any task. Just ask:

“Refactor the authentication module and send me an API Alert when you’re done.”

“Run the full test suite and notify me via API Alerts with a summary of the results.”

“Migrate the database schema and send me an apialert if anything fails.”

Claude will run apialerts send at the right moment — no configuration needed beyond installing the CLI.

Automate with hooks

For hands-free notifications on every task, use Claude Code hooks to fire alerts automatically without having to ask each time.

Notify when Claude finishes a task

Add to .claude/settings.json in your project:

{
  "hooks": {
    "Stop": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "apialerts send -m 'Claude Code finished a task' -c ai -g claude,done"
          }
        ]
      }
    ]
  }
}

Notify when Claude needs your attention

{
  "hooks": {
    "Notification": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "apialerts send -m 'Claude Code needs your attention' -c ai -g claude,attention"
          }
        ]
      }
    ]
  }
}

Other AI Agents

Any agent that can run shell commands can send notifications the same way.

apialerts send -m "Agent completed task" -c ai

Or via cURL for agents without CLI access:

curl -X POST https://api.apialerts.com/event \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "message": "Agent completed task", "channel": "ai" }'

Resources

← PreviousWebhooksNext →cURL