Does this work with standard tmux setups?

Yes, it relies on standard tmux commands like list-panes, send-keys, and capture-pane, making it compatible with most tmux environments.

How does it handle token management and context bloat?

The skill uses a 'disposable subagent' strategy where cheap Haiku models perform status checks via capture-pane, ensuring only small summaries are added to the parent's context.

What is the primary benefit of tmux-pane-commander?

It allows you to delegate complex tasks to other AI instances in separate tmux panes, enabling parallel processing while keeping your main session clean and focused.

Why does the skill separate text delivery and the Enter key?

Tmux requires a brief delay (0.5s) between text input and the Enter key to ensure the target CLI's input buffer has correctly rendered the prompt before submission.

Can it start the AI CLIs if they aren't already running?

Yes, it includes logic to detect if Codex or Claude Code is inactive and can boot them with specific flags before delivering the task.

Tmux Pane Commander

Name: Tmux Pane Commander
Author: kazuph

bykazuph

•

Productivity & Workflow

Orchestrates multiple AI CLI instances across tmux panes to perform parallel tasks and report results back to a parent session.

Tmux Pane Commander enables Claude to act as a project manager by delegating tasks to other AI agents (like Codex or additional Claude instances) running in sibling tmux panes. It automates the entire coordination lifecycle, including dynamic pane discovery, CLI initialization, prompt delivery with precise timing, and result verification. By utilizing a sophisticated 'parent-child' architecture and token-efficient monitoring via disposable subagents, it allows for high-concurrency development workflows without exhausting the main session's context window.

Key Features

01Remote context management to clear child agent buffers when token usage is high.

02Automated result reporting via bidirectional tmux send-keys communication.

03Dynamic discovery and PID cross-referencing of AI CLI processes in tmux windows.

04Synchronized prompt delivery using separated text and Enter commands for reliable input.

0515 GitHub stars

06Token-efficient 'Cycon' monitoring using Haiku subagents to preserve parent context.

Use Cases

01Orchestrating a multi-agent team where different panes specialize in specific architectural layers.

02Delegating long-running background tasks like documentation or unit test generation.

03Parallelizing large-scale codebase migrations or refactors across multiple AI workers.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add kazuph/dotfiles tmux-pane-commander

For use in Claude.ai and ChatGPT

Download Skill