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, with 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