Hooked 1.1.1 Local hooks toolkit
Hooked
Overview
Hooked connects Claude Code hooks to useful local signals. It can announce when attention is needed, keep a session moving toward a clear objective, preserve event history, and open a temporary local dashboard when you want the wider view.
Hear about permissions, waiting states, and completed work.
Keep working toward an objective or until a command succeeds.
Review status and history without sending project state to an account.
Until loops are opt-in. Hooked only continues a session after you explicitly set an objective or check command.
Install
The installer downloads Hooked, installs its dependencies with your available package manager, and configures Claude Code hooks. It requires Node.js, Git, and pnpm, Bun, or npm.
curl -fsSL https://hooked.arach.dev/install | bashThe installer enables voice announcements, prepares until loops, and adds the /hooked slash command.
Status
Run status from a project directory to see the current project context, voice setting, active alerts, registered sessions, and until-loop state.
hooked statusHooked scopes pending until work to the current project or active session whenever it can identify one.
Until loops
Use an objective when “done” needs human judgment, or a check command when success can be tested directly.
hooked until "Finish the migration and verify the result"hooked until check "pnpm test"hooked untilShow pending and active loopshooked until pauseStop after the current cyclehooked until offClear pending and active loopsVoice alerts
Voice alerts are useful when you are away from the terminal or focused elsewhere. Toggle them at any time, or set volume directly.
hooked speak onEnable announcementshooked speak 0.5Set volume from 0.0 to 1.0hooked speak offDisable announcementsDashboard
The local dashboard shows recent history, active alerts, and current state. By default it opens on port 3456 and closes after ten minutes.
hooked webhooked web 8080 30Use port 8080 and close after 30 minuteshooked web --foregroundKeep the server attached to the terminalHistory
History stays local and can be listed, searched, summarized, exported, or pruned from the CLI.
hooked historyShow the 20 most recent eventshooked history 50Choose the number of eventshooked history statsSummarize counts by projecthooked history search "permission"Search stored eventshooked history export jsonExport all events as JSONhooked history prune 30Remove events older than 30 daysConfiguration
Hooked stores its configuration, session state, and history under ~/.hooked. Prefer the CLI for routine changes so the stored format can evolve without changing your workflow.
- Voice
hooked speak on|offor a volume from0.0to1.0- Until state
- Scoped to a pending project or active session
- Dashboard
- Local server with an automatic close timeout by default
- History
- Local event records with explicit export and pruning commands
Native HUD
The native preview turns local events into compact notch or floating-island signals on macOS 14 and newer. It supports status levels, short context, timed collapse, hover, pinning, and optional URL actions.
Physical notch and floating island, event levels, hover, timing, pinning, and URL actions.
Local events work today. Automatic npm-to-HUD delivery is in progress.
Signing, notarization, public updates, and additional native surfaces are in progress.
Commands
| Command | Purpose |
|---|---|
hooked status | Show current Hooked state |
hooked clear | Clear alerts for the current project |
hooked clear all | Clear all active alerts |
hooked until … | Create, inspect, pause, or clear an until loop |
hooked speak … | Read or change voice settings |
hooked web | Open the local dashboard |
hooked history … | List, search, export, summarize, or prune history |
hooked alert | Show active alerts |
hooked statusline | Show Claude Code status-line setup |