Hooks, alerts, and a local HUD

Local hooks.
Clear signals.

Hooked adds voice alerts, until loops, history, and a local dashboard to Claude Code, with a native macOS HUD in progress.

  • MIT npm package
  • Local by default
  • Node 18+ · macOS HUD
HOOKED

CLAUDE · STOP HOOKNOW

Checking the release build

Round 3 · tests still running

01 The top edge of your screen becomes a quiet line back to the work.

Why HookedAttention is finite

Stop checking.
Start knowing.

Background work shouldn’t demand foreground attention. Hooked turns local events into the right signal at the right moment.

01

Glance, don’t go looking.

Live status lives at the edge of your workspace—not buried in another tab, terminal, or dashboard.

02

Only expand when it matters.

A compact signal becomes useful context on event or hover, then gets out of the way on its own.

03

Jump straight to the work.

Attach an action URL to an event and get back to the exact place that needs your attention.

Signal, not noise

The whole story
in a few pixels.

Hooked turns hook activity into a clear state, useful context, and an optional next step. Nothing more until you ask for it.

HOOKED
CLAUDE · UNTILRunning the full test suite142 checks · round 3

One status languageInfo, success, warning, or error

Useful contextSource, kind, title, and detail

Direct actionJump back with an attached URL

Made for the Mac

Built for the notch.
Not trapped by it.

The new Hooked HUD detects the real hardware notch when it’s there and becomes a compact floating island when it isn’t—including on external displays.

  • Physical notch and virtual island modes
  • Configurable dwell, timing, and geometry
  • Pin a signal when you want it to stay

One local hooks layer

Hook any tool.
Choose how it reaches you.

The published package handles Claude Code hooks today. Local scripts and structured events can feed the native HUD preview; automatic delivery between the two is still in progress.

Claude hooksPermission, stop, complete

›_

Local scriptsBuilds, tests, deploys

{ }

Structured eventsAnything that emits JSON

HookedLocal hooks layer

The right signalVoice · HUD · dashboard

zsh — keep going until it passes
$ hooked until check "pnpm test"

Until loop pending.
Command: pnpm test
Check registeredsession-local · explicit override

Local by design

Your work reports
to your Mac.

Hooked keeps state, history, and the HUD’s event path on your machine. You decide which hooks run, what they announce, and when they stop.

01Local stateConfig, sessions, and history stay close
02Opt-in loopsContinuation is off until you enable it
03Published packageThe npm package is MIT licensed

One utility, fewer check-ins

More than a notification.

01

Continue until it works

Define “done” with any check command or a manual objective. Hooked keeps the run moving until the condition is met.

Until
02

Hear when you’re needed

Voice alerts through SpeakEasy announce permissions, waiting states, and completed work when you’re away from the screen.

Voice
03

See the right signal

The native macOS HUD turns hook events into compact, short-lived context at the edge of your workspace.

HUD
04

Review on your terms

Spin up the local dashboard for event history and settings, then let it close itself when you’re finished.

Dashboard

Hooked 1.1.1 · npm package

Install Hooked.
Keep working.

Install the hooks helper today for voice alerts, until loops, and the local dashboard. The native macOS HUD is joining the same local layer.

Read the docs View on GitHub

The macOS HUD shown above is being folded into Hooked and is not yet included in the published npm package.

Copied to clipboard