pchalasani/claude-code-tools

Overview

This skill provides a CLI utility to communicate with other CLI agents or scripts running in different tmux panes. It exposes commands to execute shell commands remotely and to coordinate with other agent instances for messaging and output capture. Use it only when you need direct pane-to-pane interaction inside tmux.

How this skill works

The tool issues commands into specified tmux panes and returns structured results such as captured output and exit codes. For shell commands use the execute command, which returns JSON with output and exit_code and supports timeouts. For agent-to-agent messaging, use a sequence of send, wait_idle, and capture to deliver messages and retrieve responses.

When to use it

• Run a build or test inside another pane and detect success or failure programmatically
• Trigger and monitor long-running jobs running in separate tmux panes
• Coordinate messages between multiple CLI agents or scripts inside tmux
• Capture output from a background agent process for logging or decision-making
• Automate multi-pane workflows where steps must abort on command failure

Best practices

• Prefer tmux-cli execute for pure shell commands; it returns exit codes to drive control flow
• For agent-to-agent chat use send + wait_idle + capture rather than execute
• Always set a sensible timeout to avoid indefinite waits when a pane becomes unresponsive
• Reference panes with clear identifiers (session:window.pane) to avoid ambiguity
• Ensure claude-code-tools is installed if the command is not found (install via the tool manager when prompted)

Example use cases

• Run test suites in a dedicated pane and abort deployment on nonzero exit code
• Send a prompt to another Claude Code agent and wait for it to finish processing before capturing its reply
• Install dependencies in an operations pane and capture the installer output for audit logs
• Orchestrate a multi-step build across panes, stopping the pipeline if any step fails
• Monitor a long-running analysis script and capture final results once it signals idle