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-hatch

Run it inside Claude Code after adding the marketplace with /plugin marketplace add craftzdog/tmux-claude-hatch.

Contents

Discovered from source

Agents 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 idle and waiting. tmux only raises an alert for a real \a written 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_cache is 'off'), so without this it can be stale — showing working for 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. preferredNotifChannel and messageIdleNotifThresholdMs are 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