Agent skill
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 this agent skill to your Project
npx add-skill https://github.com/pchalasani/claude-code-tools/tree/main/plugins/tmux-cli/skills/tmux-cli
SKILL.md
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.
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
msg
Inter-agent communication via the msg CLI. Use this when you need to send messages to other agent sessions, read incoming messages, or coordinate with other agents in tmux panes.
code-walk-thru
Use this when user wants you to walk through (code or text) files in a EDITOR to either explain how some code works, or to show the user what changes you made, etc. You would typically use this repeatedly to show the user your changes or code files one by one, sometimes with specific line-numbers. This way the user is easily able to follow along in their favorite EDITOR as you point at various files possibly at specific line numbers within those files.
make-issue-spec
socratic-quiz
Use this when the user wants to deeply understand something through guided questioning. Trigger phrases include: "quiz me", "help me understand", "Socratic", "teach me", "walk me through with questions", "test my understanding", or when the user asks for an explanation and would benefit more from guided discovery than a direct answer.
log-work
session-search
For CLI agents WITHOUT subagent support (e.g., Codex CLI). Search previous code agent sessions for specific work, decisions, or code patterns.
Didn't find tool you were looking for?