Claude Code

Claude Code stops and waits when it needs your permission, to run a command or edit a file. At your desk, you answer in the terminal. Away from it, Pocketbell brings the prompt to your iPhone, iPad and Mac, with Allow and Deny right on the notification, and Claude Code carries on.

Nothing runs on your computer. Claude Code sends its prompts straight to Pocketbell over HTTPS, using its own hooks.

Set it up

In the Pocketbell app, create a Source and choose Claude Code. Copy its key.
Make the key available to Claude Code. In ~/.zshrc, or your shell’s equivalent:
Terminal window
```
export POCKETBELL_KEY=pb_live_…
```

Install the Pocketbell plugin, from inside Claude Code:

/plugin marketplace add srworksllc/pocketbell-claude-code
/plugin install pocketbell@pocketbell

Start a new Claude Code session. In the app, Send Test on the Source sends a sample prompt with Allow and Deny, so you can see how one looks.

Without the plugin

The plugin only adds hooks. To add them yourself, put this in ~/.claude/settings.json:

{
  "hooks": {
    "PermissionRequest": [
      {
        "hooks": [
          {
            "type": "http",
            "url": "https://hooks.pocketbell.dev/v1/claude-code",
            "timeout": 600,
            "headers": { "Authorization": "Bearer $POCKETBELL_KEY" },
            "allowedEnvVars": ["POCKETBELL_KEY"]
          }
        ]
      }
    ],
    "Notification": [
      {
        "matcher": "idle_prompt",
        "hooks": [
          {
            "type": "http",
            "url": "https://hooks.pocketbell.dev/v1/claude-code",
            "headers": { "Authorization": "Bearer $POCKETBELL_KEY" },
            "allowedEnvVars": ["POCKETBELL_KEY"]
          }
        ]
      }
    ]
  }
}

What happens to a prompt

Claude Code shows the prompt in your terminal and sends it to Pocketbell at the same moment.
Pocketbell waits about a minute. Answer in the terminal in that time and nothing is sent to your devices.
Still unanswered, it arrives as a notification: the tool, the command or file, and the project. Tap Allow or Deny.
Claude Code gets your answer and carries on. Whichever answer comes first, the terminal’s or your device’s, is the one that counts.

If nobody answers before the hook’s timeout, Claude Code keeps asking in the terminal. Nothing is ever allowed by default, and if Pocketbell can’t be reached, Claude Code simply asks in the terminal as it always has.

When Claude Code finishes and has been waiting on you for a while, you get a plain “waiting for you” notification.

Settings on the Source

Wait before notifying: about a minute by default. Shorter if you want your phone to take over sooner, longer if you step away often and briefly.
No terminal: for Claude Code running on a server, in a container or in the cloud. Prompts are sent at once, without the wait.
Priority: prompts arrive as Important by default, which can break through a Focus. Choose Normal and they arrive silently during quiet hours.

Good to know

Long commands show their first line in the notification. Tap it for the whole command, or the whole edit, with Allow and Deny there too. If you can’t read all of it, Deny is the safe answer.
Several sessions at once: each prompt names its project, and each answer goes to the prompt it was given for.
Subagents: Claude Code waits for a hook before it shows a subagent’s prompt, so Pocketbell doesn’t hold those. You get a “waiting for you” notification, and answer in the terminal.
An answer that arrives too late, after the session ended or the computer went to sleep, is never applied. The notification says it’s no longer waiting.
What’s sent: the tool’s name, its input (the command, or the file and the edit), and the project’s folder name. Commands can contain secrets, such as a token in an argument; they are kept in your inbox for your plan’s history, like any notification. Deleting a notification erases its text from our servers at once.
Limits: only prompts that reached your devices count, toward your notifications and toward the 30 answered questions a month on Free. Pro has no limit on answers. When Free’s answers run out, prompts stay in the terminal until the month resets, and you get one notification saying so.