stevengonsalvez/tmux-message
toolkit/packages/skills/tmux-message/SKILL.md
Reliable peer-to-peer message delivery to other Claude Code instances via tmux send-keys. Use as a fallback when claude-peers MCP send_message fails to surface in the receiver's inbox (delivered server-side but receiver never picks it up — observed behaviour). Also use when sending a directive to a known Claude Code TUI session by tmux session name or fuzzy hint, or when injecting a multi-line directive into a peer's prompt and submitting it. Trigger phrases — "claude-peers fallback", "tmux send-keys", "send to peer via tmux", "inject directive", "deliver to nanoclaw/hermes peer", "peer message". Tmux-only — won't reach peers running outside tmux.
$ install --global
skillsauthnpx skillsauth add stevengonsalvez/agents-in-a-box tmux-messageInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: May 8, 2026, 4:41 AM229.5s2 files scanned
SKILL.md
- name:
- tmux-message
- description:
- Reliable peer-to-peer message delivery to other Claude Code instances via tmux send-keys. Use as a fallback when claude-peers MCP send_message fails to surface in the receiver's inbox (delivered server-side but receiver never picks it up — observed behaviour). Also use when sending a directive to a known Claude Code TUI session by tmux session name or fuzzy hint, or when injecting a multi-line directive into a peer's prompt and submitting it. Trigger phrases — "claude-peers fallback", "tmux send-keys", "send to peer via tmux", "inject directive", "deliver to nanoclaw/hermes peer", "peer message". Tmux-only — won't reach peers running outside tmux.
tmux-message
Deliver a message to another Claude Code TUI session running in tmux. Use the bundled scripts/send.sh — it handles session resolution, pre-flight safety checks, paste-buffer delivery, and post-flight verification.
When to use
- claude-peers MCP
send_messagereturned success but the receiver never acted on the message (silent failure mode observed in this fleet). - Sending a directive/handoff to a peer Claude Code session whose tmux session name is known (full or fuzzy).
- Need to inject a multi-line message into another Claude Code TUI prompt and submit it as if the user typed it.
Do NOT use for — peers outside tmux, shell-only sessions (no Claude Code TUI), or one-shot commands you would just paste yourself.
Usage
# Send file content
~/.claude/skills/tmux-message/scripts/send.sh <session-or-hint> <message-file>
# Send via stdin
echo "ping from hermes peer" | ~/.claude/skills/tmux-message/scripts/send.sh nanoclaw -
<session-or-hint> accepts either an exact tmux session name OR a unique substring. tmux ls is grepped — if zero or multiple matches, the script aborts and lists them.
Workflow
-
Compose the message in a file. Always prefix with an origin marker so the receiver knows where it came from:
[from <my-peer-id-or-cwd>] <directive body> -
Run send.sh. It will:
- Resolve the session (exact → fuzzy)
capture-paneand check for: idle❯prompt (good), activity spinner (warn), permission prompt (abort)load-buffer→paste-buffer→Enter- Re-capture pane and report whether an activity indicator appeared (i.e. receiver submitted)
-
Inspect the receiver afterwards if needed:
tmux capture-pane -t <session> -p | tail -20
Safety gates
The script aborts in these cases (override carefully):
- Permission prompt detected (
Do you want to allow/approve/run) — paste would be captured by the prompt handler instead of routed as input. Always abort. No override. - Mid-tool-call activity (
✻,✢,⚒,Frosting…, etc.) with no idle prompt visible — queueing into the current input buffer is risky. Override withTMUX_MESSAGE_FORCE=1only when you understand the receiver state.
Edge cases
- Long messages (>5KB) — paste-buffer may exceed tmux buffer limits on some versions. Prefer writing the body to a file the receiver can read; the message you send is then just
see /tmp/handoff-X.md. - Receiver at shell prompt (no Claude Code) — paste still happens; Enter runs it as a shell command. Pre-flight catches absence of
❯and warns. Remote Control activeline in status bar — indicates/remote-controlskill is running on the receiver. Delivery still works.- Multiple panes in the session — script targets the active pane only. For multi-pane sessions, append
:0.0(window:pane) to the session name in the first arg.
Tradeoffs
- Tmux-only.
- Receiver sees the message as if the user typed it. Provenance only via the
[from X]prefix you include — no read receipts. - Post-flight check confirms an activity indicator appeared but not that the receiver actually understood the directive. Treat as "delivered" not "actioned".
- Message files at
/tmp/tmux-message-*.txtare NOT auto-cleaned; that's intentional for replay/debugging. Sweep periodically.
Related Skills
stevengonsalvez/reflect:cost
documentation
VerifiedTrustedCommunity
Report reflect drain spend over a time window — tokens split by cached (cache_read), uncached writes (cache_creation), and io (input+output), with a $ estimate, grouped by day / outcome / model / transcript. Reads the drainer's cost log and surfaces outlier runs and cache-reuse health (the 41.5M-token failure mode = low cache reuse + high cache writes). Use to answer "what is reflection costing me" for the last day / week.
12SKILL.mdUpdated Jun 2, 2026
stevengonsalvez/ainb-fleet:standup
development
VerifiedTrustedCommunity
Show fleet status — every claude session running on the host, merged across ainb + claude-peers broker + background jobs. Use when you need to enumerate sessions before composing an action, see which sessions have a peer registered (broker-routable) vs tmux-only, check the `summary` of each session, or pipe the list into jq for filtering. Default output: text table. Pass --format json for LLM consumption.
10SKILL.mdUpdated May 31, 2026
stevengonsalvez/ainb-fleet:sequence
testing
VerifiedTrustedCommunity
Ordered multi-step prompts to fleet targets, ack-gated between steps via JSONL assistant-turn-end detection. Use for cycles like disconnect→reconnect→verify, or any flow where step N+1 requires step N to have completed first. The skill BLOCKS until each target's transcript shows the next assistant turn finishing OR per-step timeout fires (default 300s).
10SKILL.mdUpdated May 31, 2026
stevengonsalvez/ainb-fleet:needs
development
VerifiedTrustedCommunity
Center control panel — enumerate every claude session that is blocked waiting on something: a user answer (AskUserQuestion fired), an API error retry, an idle assistant turn-end with no follow-up, or an explicit WAITING: marker. Returns rich JSON with signal kind + context per session. Use this when you've stepped away from the fleet and want one place to see everything that wants your attention and answer it.
10SKILL.mdUpdated May 31, 2026