
tmux-claude-hatch
Companion hooks for tmux-claude-hatch: ring the terminal bell when an agent needs you, and keep the picker's agent cache fresh.
- GitHub stars
- 408
Install
/plugin install tmux-claude-hatch@tmux-claude-hatchRun it inside Claude Code after adding the marketplace with /plugin marketplace add craftzdog/tmux-claude-hatch.
Contents
Discovered from sourceAgents 1
tmux-claude-hatch
A Claude Code plugin that
ships the hook configuration
tmux-claude-hatch
wants, so you don't have to paste JSON into ~/.claude/settings.json.
It does two things:
- Rings the terminal bell when an agent ends a turn, asks for permission, or
asks you a question — the three moments the picker calls
idleandwaiting. tmux only raises an alert for a real\awritten to a pane's pty, which is what makes window-status alerts and this plugin's bell forwarding fire. - Refreshes the picker's agent cache on those same events, plus session
start/end and prompt submit. The picker paints its first frame from that cache
(unless
@claude_picker_cacheis'off'), so without this it can be stale — showingworkingfor an agent that has been waiting on you.
Install
/plugin marketplace add craftzdog/tmux-claude-hatch
/plugin install tmux-claude-hatch@tmux-claude-hatch
Notes
- Both hooks are silent, always exit
0, and run the cache refresh detached, so a failure never fails a turn and nothing lands in the transcript. - The cache refresh is skipped entirely when the agent is not inside tmux — it would otherwise overwrite a good cache with an empty one.
- This covers the hook route only.
preferredNotifChannelandmessageIdleNotifThresholdMsare user settings a plugin cannot set; see Making Claude ring the bell if you'd rather use Claude's built-in bell than a hook.
Sponsors
Details
- Marketplace
- craftzdog/tmux-claude-hatch
- Source
- plugins/tmux-claude-hatch
- Category
- Community