Claude finished coding.
Your phone knows.

Built into Claude Code, zero setup

In Ghostty, Kitty, and iTerm2, Claude Code already sends a desktop notification when it finishes or pauses for permission, and it reaches your local machine even over SSH. In other terminals, switch the notification channel to the terminal bell. Most guides still tell you to run `claude config set --global preferredNotifChannel terminal_bell`, which now fails with `error: unknown option '--global'`: the config subcommand was removed, so set it in settings.json instead. Or run the one-liner below, which adds a Notification hook that rings the bell and raises the desktop alert itself, so it works whatever channel you are on. Either way it stays on this machine and cannot reach you once you step away.

npx @pushary/agent-hooks@latest bell

Deterministic, fires on permission prompts and idle waits

Claude Code fires a Notification event when it needs your approval (permission_prompt) or is done and waiting for your next prompt (idle_prompt). A hook in .claude/settings.json turns that into any command you want, like a macOS notification via osascript or notify-send on Linux. Add a matcher such as permission_prompt to only fire for specific types. This is the mechanism most DIY tutorials skip: no prompt hacks in CLAUDE.md, just a documented event.

{
  "hooks": {
    "Notification": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "osascript -e 'display notification \"Claude Code needs you\" with title \"Claude Code\"'"
          }
        ]
      }
    ]
  }
}

A Stop hook plus curl reaches your phone, one-way

The Stop event fires when Claude finishes responding. Point a Stop hook at ntfy.sh and your phone gets a push for free. The trade-offs: it is one-way, so when Claude is blocked on a question you still have to walk back to the terminal to answer, and public ntfy topics are readable by anyone who guesses the name unless you reserve one or self-host.

{
  "hooks": {
    "Stop": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "curl -s -d 'Claude Code finished' ntfy.sh/your-topic"
          }
        ]
      }
    ]
  }
}

The only option where you can answer Claude remotely

One command installs the hooks and connects Claude Code over MCP. You get a push when Claude finishes, and when it is blocked on a permission or a question, the notification carries the question itself. Tap yes or no from your lock screen and Claude continues. Permission policies decide which tools need your approval, and every decision lands in an audit trail. This is the difference from every free option above: they tell you Claude is waiting, Pushary lets you unblock it.

npx @pushary/agent-hooks@latest setup