Claude-code-tools tmux-cli

CLI utility to communicate with other CLI Agents or Scripts in other tmux panes; use it only when user asks you to communicate with other CLI Agents or Scripts in other tmux panes.

install

source · Clone the upstream repo

git clone https://github.com/pchalasani/claude-code-tools

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/pchalasani/claude-code-tools "$T" && mkdir -p ~/.claude/skills && cp -r "$T/plugins/tmux-cli/skills/tmux-cli" ~/.claude/skills/pchalasani-claude-code-tools-tmux-cli && rm -rf "$T"

manifest: plugins/tmux-cli/skills/tmux-cli/SKILL.md

source content

tmux-cli

Instructions

Use the

tmux-cli

command to communicate with other CLI Agents or Scripts in other tmux panes. Do

tmux-cli --help

to see how to use it!

This command depends on installing the

claude-code-tools

. If you get an error indicating that the command is not available, ask the user to install it using:

uv tool install claude-code-tools

Key Commands

Execute with Exit Code Detection

Use

tmux-cli execute

when you need to know if a shell command succeeded or failed:

tmux-cli execute "make test" --pane=2
# Returns JSON: {"output": "...", "exit_code": 0}

tmux-cli execute "npm install" --pane=ops:1.3 --timeout=60
# Returns exit_code=0 on success, non-zero on failure, -1 on timeout

This is useful for:

Running builds and knowing if they passed
Running tests and detecting pass/fail
Multi-step automation that should abort on failure

Note:

execute

is for shell commands only, not for agent-to-agent chat. For communicating with another Claude Code instance, use

send

wait_idle

capture

instead.