Skip to content

feat: dispatch claude hooks via signalbox with tmux-notify fallback #104

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
dwmkerr wants to merge 3 commits into
base: main
Choose a base branch
from
Open

feat: dispatch claude hooks via signalbox with tmux-notify fallback #104

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
12a5520
feat: dispatch claude hooks via signalbox with tmux-notify fallback
dwmkerr Jul 7, 2026
8e43cce
fix: exec signalbox from the dispatcher so the agent stays the parent
dwmkerr Jul 7, 2026
d330e61
fix: use 'signalbox hook claude' (grouped CLI form)
dwmkerr Jul 8, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
20 changes: 20 additions & 0 deletions claude/hooks/agent-notify.sh
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
#!/usr/bin/env bash
# Claude Code hook dispatcher. Prefers signalbox (which fires the session
# event AND applies the tmux signals itself); falls back to the plain tmux
# notify behaviour when signalbox is not installed. Always exits 0 — a
# notifier must never break the agent that calls it.
# exec (stdin passes straight through): one less shell in the process tree,
# so signalbox can identify the agent process for its liveness tracking.
if command -v signalbox >/dev/null 2>&1; then
exec signalbox hook claude 2>/dev/null
fi

payload="$(cat)"

# No signalbox on this machine: keep the original in-terminal signals.
dir="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
case "$payload" in
*'"hook_event_name":"Notification"'*) "$dir/tmux-notify.sh" 2>/dev/null ;;
*'"hook_event_name":"UserPromptSubmit"'*) "$dir/tmux-notify.sh" clear 2>/dev/null ;;
esac
exit 0
36 changes: 33 additions & 3 deletions claude/settings.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -63,7 +63,17 @@
"hooks": [
{
"type": "command",
"command": "~/.claude/hooks/tmux-notify.sh"
"command": "~/.claude/hooks/agent-notify.sh"
}
]
}
],
"Stop": [
{
"hooks": [
{
"type": "command",
"command": "~/.claude/hooks/agent-notify.sh"
}
]
}
Expand All @@ -73,7 +83,27 @@
"hooks": [
{
"type": "command",
"command": "~/.claude/hooks/tmux-notify.sh clear"
"command": "~/.claude/hooks/agent-notify.sh"
}
]
}
],
"SessionStart": [
{
"hooks": [
{
"type": "command",
"command": "~/.claude/hooks/agent-notify.sh"
}
]
}
],
"SessionEnd": [
{
"hooks": [
{
"type": "command",
"command": "~/.claude/hooks/agent-notify.sh"
}
]
}
Expand Down Expand Up @@ -159,4 +189,4 @@
"alwaysThinkingEnabled": true,
"skipDangerousModePermissionPrompt": true,
"effortLevel": "xhigh"
}
}