---
name: Tmux CLI
slug: tmux-cli
category: Automation
description: Tmux CLI lets a Claude Code agent send commands and messages to other CLI agents or scripts running in separate tmux panes. Use it when you need to coordinate work across multiple panes, run shell commands with exit code detection, or communicate with another Claude Code instance.
github: "https://github.com/pchalasani/claude-code-tools/tree/main/plugins/tmux-cli/skills/tmux-cli"
language: Python
stars: 1979
forks: 128
install: "npx degit https://github.com/pchalasani/claude-code-tools/tree/main/plugins/tmux-cli/skills/tmux-cli ~/.claude/skills/tmux-cli"
installs_to: ~/.claude/skills/tmux-cli
source_path: plugins/tmux-cli/skills/tmux-cli/SKILL.md
collection_size: 17
category_size: 1523
collection_url: "https://dirskills.com/collections/pchalasani/claude-code-tools"
added: 2026-08-18T06:58:51.660Z
last_synced: 2026-08-18T06:58:51.660Z
canonical_url: "https://dirskills.com/skills/tmux-cli"
---

# Tmux CLI

Tmux CLI lets a Claude Code agent send commands and messages to other CLI agents or scripts running in separate tmux panes. Use it when you need to coordinate work across multiple panes, run shell commands with exit code detection, or communicate with another Claude Code instance.

**Install:**

```bash
npx degit https://github.com/pchalasani/claude-code-tools/tree/main/plugins/tmux-cli/skills/tmux-cli ~/.claude/skills/tmux-cli
```

## README

# 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:

```bash
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.