tmux-cli

A command-line tool for sending messages and running shell commands in other tmux panes, which are terminal windows managed together.

In plain words
What is it for?
Running builds and tests in another pane, stopping automation after failures, and exchanging messages with another agent.
Why use it?
It helps coordinate several command-line agents or scripts and detect whether their commands succeeded.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/pchalasani/claude-code-tools/tmux-cli
Any agent
npx skills add pchalasani/claude-code-tools --skill tmux-cli
Clone the repo
git clone --depth 1 https://github.com/pchalasani/claude-code-tools

Made for: Claude Code, Codex.

Per session 41 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 319 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00041 $0.00319
Opus 5 $0.00020 $0.00160
Sonnet 5 $0.00008 $0.00064
Haiku 4.5 $0.00004 $0.00032

Measured 2d ago against content hash 5b2a3048308e, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

tmux-cli scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

plugins/tmux-cli/skills/tmux-cli/SKILL.md · 44 lines

What it actually says

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.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 44 lines · 41 tokens per session scan A 5b2a3048308e

Subscribe to this mod's changes

tmux-cli is a skill published in the GitHub repository pchalasani/claude-code-tools (1,989 stars, last pushed 2d ago), licensed MIT. It adds 41 tokens to every session and 319 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

verify-behavior

Verify or reproduce visible product behavior by driving the real UI with pi-computer-use's checked tools, requiring verified expect postconditions and durable state evidence for meaningful UI flows. Use when triage needs visual reproduction, implementation needs behavioral proof, review needs interactive confirmation…

nicknisi/dotfiles · 68 tokens

bro

Restate the last message in plain human language, with no jargon.

nicknisi/dotfiles · 16 tokens

database-engineer

SQLite database expertise for migrations, multi-tenant patterns, transactional safety, FTS5 virtual tables, and schema evolution. Use this skill for ANY work involving schema changes, data migrations, INSERT/UPSERT semantics, FTS5 rebuilds, transaction rollback design, multi-tenant data isolation, or SQLite…

Vinix24/vnx-orchestration · 121 tokens

monitoring-specialist

System monitoring, alerting, and observability implementation.

Vinix24/vnx-orchestration · 15 tokens

t0-orchestrator

Master orchestration for the VNX multi-terminal system. Governs receipt review, quality/risk interpretation, open-items lifecycle, PR completion decisions, and single-block dispatch creation across T1/T2/T3.

Vinix24/vnx-orchestration · 48 tokens

panel

Multi-provider deliberation panel for COMPLEX, multi-view questions — architecture, strategy, market research, and codebase sweeps. Runs a 4-stage deliberation across the provider fleet (diverge → contrarian red-team → adversarial verify → cited synthesis), the same multi-perspective rigour the plan-gate already…

Vinix24/vnx-orchestration · 100 tokens