Blip
← All guides

Get a push notification when your AI agent finishes

You give Claude Code, Cursor, or another coding agent a long task and walk away. Then you keep coming back to check if it is done. One HTTP call when it stops lets your phone tell you instead.

1

Create an Agents channel in Blip

Install the Blip iOS app, tap + to create a channel named Agents, and copy its key (it starts with blip_live_). Save it in your shell profile as BLIP_AGENT_KEY. Claude Code passes your environment to its hooks, so the key never has to sit in a project file.

~/.zshrc
# in ~/.zshrc or ~/.bashrc, then open a new terminal
export BLIP_AGENT_KEY="blip_live_xxx"
2

Send one test call

This is the whole integration: one HTTP call with your key and a title (up to 200 characters). The body is optional (up to 2000). Run it once to see the push land.

terminal
curl -X POST https://blipnotify.com/api/v1/notify \
  -H "Authorization: Bearer $BLIP_AGENT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title":"Claude Code is done","body":"It stopped and is waiting for you."}'

201 { "ok": true, "delivered": 1, "devices": 1 } · pushed to your iPhone

3

Add a Stop hook to Claude Code

Claude Code runs a Stop hook each time it finishes responding. Paste this into .claude/settings.json in your project (or ~/.claude/settings.json for every project). If the file already has a hooks block, add the Stop entry to it.

.claude/settings.json
{
  "hooks": {
    "Stop": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "curl -s -o /dev/null -X POST https://blipnotify.com/api/v1/notify -H \"Authorization: Bearer $BLIP_AGENT_KEY\" -H \"Content-Type: application/json\" -d '{\"title\":\"Claude Code is done\",\"body\":\"It stopped and is waiting for you.\"}'"
          }
        ]
      }
    ]
  }
}

-o /dev/nullthrows away Blip's reply so Claude Code does not try to read it as hook output.

When it fails or needs you

Stop does not run when the turn ends on an API error, like a rate limit. Claude Code fires StopFailureinstead. Add the same entry under that name too, with a title like "Claude Code hit an error".

For "waiting for your OK", add a Notification entry with "matcher": "permission_prompt". It runs when Claude needs you to approve something and the prompt has waited about six seconds. Add "priority":"high"to that JSON so Apple sends the push right away instead of when it suits your phone's battery.

One thing to know: Stop runs after every reply, not only at the end of a big task. In a quick back-and-forth chat, your phone will buzz each time. Put the hook in the projects where you run long tasks. Each channel takes up to 60 blips a minute.

Cursor or any other agent

Any agent that can run a shell command can send the same one HTTP call. Add a line like this to its rules or to your prompt. It works as long as the agent follows the instruction, so a real hook, like the Claude Code one above, is the surer bet.

agent rules
When you finish the task, or get stuck and need me, run this once:
curl -s -X POST https://blipnotify.com/api/v1/notify \
  -H "Authorization: Bearer $BLIP_AGENT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title":"Agent is done","body":"Come take a look."}'

That's the whole setup.

Blip is free to try for 14 days, every feature included. After that it is $29.99/yr or $9/mo: see pricing.

Download on the App Store

More guides