Get a Text When Claude Code Needs You: “alertme on”

Leave a long Claude Code job running and walk away. Type alertme on in the session, and whenever Claude stops to ask your permission or waits for your next instruction, you get a text. alertme off stops it.

Want the simplest setup instead, with no download? See Get a Text When Claude Code Finishes: a two-line hook, or the UserAlertX connector so Claude Code can text you a summary.

What the texts look like

Claude needs you (myproject): Claude needs your permission to use Bash

When Claude finishes a reply, you get a "waiting for you" text with the start of its answer, if you haven't typed anything within a minute.

Set it up (about 5 minutes)

  1. Save uxclaude.py as ~/.claude/uxclaude.py (Windows: %USERPROFILE%\.claude\uxclaude.py).
  2. Save your API key once by running uxsend, or put it in ~/.useralertx_key. The key is on your account screen.
  3. Add these hooks to ~/.claude/settings.json. If you already have a "hooks" section, merge them into it. On Windows use python instead of python3. 
    "hooks": {
  "UserPromptSubmit": [
    { "hooks": [ { "type": "command", "command": "python3 ~/.claude/uxclaude.py prompt" } ] }
  ],
  "Stop": [
    { "hooks": [ { "type": "command", "command": "python3 ~/.claude/uxclaude.py stop" } ] }
  ],
  "Notification": [
    { "matcher": "permission_prompt",
      "hooks": [ { "type": "command", "command": "python3 ~/.claude/uxclaude.py notify" } ] }
  ]
}

Claude Code picks up the change on its own. Try it without sending anything: set USERALERTX_DRYRUN=1.

Using it

  • alertme on / alertme off in the session; alertme alone tells you whether it's on.
  • It only affects the session you turned it on in, and sends at most one text a minute.
  • Permission requests text you after a few seconds.
  • Cost: 1 token per text (a plan includes 50 tokens a month).
Examples Home UserToolX