Let Claude Code Ping You When It Needs You

The most expensive part of a long agent run is often not the compute. It is the glance back at the terminal every few minutes.

Did it finish? Did it fail? Is it waiting for permission? Can I leave the desk yet?

PingRoom CLI v0.4 adds a hook command for Claude Code. It turns Claude Code lifecycle events into Pings, so the work can call you back at the moment your attention is useful.

Events, not polling

Hooks run when something happens. That makes them a better fit than a timer, a log scraper, or another window you have to remember to watch.

Configure Claude Code to invoke the PingRoom hook for the moments you care about, and the CLI translates the event into a room signal. The hook reads the event payload, produces a concise Ping, and exits cleanly so it does not get in the agent's way.

Attention becomes part of the workflow

The useful pattern is not "send every log line to my phone." It is to choose the transitions where a person can change the outcome:

• A long task completed and is ready to review.
• Claude Code stopped and needs input.
• A permission boundary needs a human decision.
• A run failed and should be inspected before anything retries.

The terminal remains the place where the work happens. PingRoom becomes the attention layer around it.

Pair it with Questions and Handoff

A plain Ping says something happened. A Question asks you to choose. A Handoff says the next step is yours.

Together they cover the common end states of an agent run. Routine completion can be a quiet Ping. A bounded decision can arrive with answer buttons. A task that needs a browser session or human judgment can be handed off with acknowledgement.

The hook is the bridge into that vocabulary. Claude Code does not need a dashboard integration, and you do not need to keep its terminal in view.

Leave the terminal without losing the thread

Developer tools have become good at working for minutes at a time. Our attention habits have not caught up; we still hover over work that no longer needs supervision.

Hooks fix the timing. PingRoom fixes the destination. Start the task, move on, and let the work tap you on the shoulder when the next human moment arrives.