gn

CLI tool to send nudge messages to Claude agents running in tmux windows.

Nudge protocol and Claude detection logic ripped straight out of gastown.

Installation

Homebrew:

brew tap nmelo/tap
brew install gn

Go:

go install github.com/nmelo/gasnudge@latest
mv $(go env GOPATH)/bin/gasnudge $(go env GOPATH)/bin/gn

Usage

From inside tmux, nudge all other windows in the current session:

gn "continue"

Nudge only windows running Claude:

gn --detect "continue"

Target specific windows:

gn -w editor -w build "done"
gn -p "worker-*" "update"

Preview without sending:

gn --dry-run "test"

Flags

-w, --window NAME      Target specific window(s) by name (repeatable)
-s, --session NAME     Target session (default: current)
-p, --pattern GLOB     Filter windows by name pattern
-d, --detect           Only nudge windows running Claude
-a, --all              Include current window (default: exclude self)
-n, --dry-run          Show what would be nudged

How it works

Uses tmux send-keys with a reliable protocol: literal mode for the message, brief delays for paste completion, Escape for vim-mode safety, and Enter with retry logic.

Claude detection checks pane_current_command for node, claude, or version patterns like 2.1.12, plus child process inspection when the pane shows a shell.

See also

• gp - read output from tmux windows
• gm - agent-to-agent messaging via beads