tmux-autopilot

Automates tmux pane management and collaboration using AI commands.

2|Updated Jan 9, 2023
One-click install
npx skills add https://github.com/arcthur/dotfiles --skill tmux-autopilot
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tmux-autopilot
Source: https://github.com/arcthur/dotfiles/tree/main/claude/.claude/skills/tmux-autopilot
Command: npx skills add https://github.com/arcthur/dotfiles --skill tmux-autopilot

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Automates tmux session management and cross-pane coordination using AI, reducing manual keystrokes and error-prone commands.

Core Features & Use Cases

  • Read pane output and summarize it for quick decisions
  • Broadcast commands to specific panes or across multiple panes
  • Batch inspect multiple terminals and coordinate actions (swarm collaboration)
  • Rescue stalled tasks by auto-detecting prompts and sending corrective input
  • Quick lookup of keybindings and pane navigation to speed up workflows

Quick Start

Start tmux-autopilot with an active tmux session to begin automated pane control.

Frequently Asked Questions about tmux-autopilot

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate tmux pane management and coordinate commands across multiple sessions?

Automating tmux pane management involves using AI to read pane output, broadcast commands, and batch inspect terminals. This reduces manual keystrokes by automatically sending commands to specific panes and coordinating actions across a swarm of workspaces.

Can I use AI to rescue stalled tasks in an active tmux session?

Yes, you can rescue stalled tasks in tmux by using AI to auto-detect prompts and send corrective input. The automation safely monitors pane output and intervenes by sending the necessary commands to resume halted processes.

Do I need a specific tmux configuration to enable AI-driven session control?

Yes, AI-driven tmux control requires Arthur's tmux configuration with base-index 1 and pane-base-index 1. This specific indexing setup ensures the automation can accurately target panes using capture-pane and send-keys commands.

What is the best way to read and summarize output from multiple tmux panes at once?

The best way to summarize multiple tmux panes is through batch inspection. AI automation captures pane output across terminals, reads the results, and provides a summarized overview for quick decision-making without manual switching.

How does AI send commands to a specific tmux pane without affecting others?

AI sends commands to a specific tmux pane by utilizing the send-keys command with precise targeting. By integrating TPM and relying on base-index 1 configurations, the automation safely directs keystrokes only to the intended terminal pane.

Are there limitations when using AI to broadcast commands across a tmux swarm?

Limitations of broadcasting across a tmux swarm include dependency on specific pane-base-index 1 configurations and TPM integration. If the active tmux session lacks this exact setup, the automated capture-pane and pipe-pane commands may fail to target correctly.