One-click install
npx skills add https://github.com/paulrobello/cctmux --skill cc-tmux
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: cc-tmux
Source: https://github.com/paulrobello/cctmux/tree/main/skill/cc-tmux
Command: npx skills add https://github.com/paulrobello/cctmux --skill cc-tmux

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Claude workflows inside tmux often suffer from pane mismanagement and unclear orchestration. This skill enables Claude to discover and manage tmux panes within a cctmux session, enabling organized workspaces with dedicated panes for development servers, file watchers, and monitors.

Core Features & Use Cases

  • Pane discovery and targeting: safely identify pane IDs and avoid sending commands to Claude's own pane.
  • Dynamic pane creation: spawn split panes for servers, watchers, and tests without losing focus.
  • Command orchestration: send keys to panes to start processes and monitor outputs within a single Claude workflow.
  • Use Case: while developing a multi-service app, Claude can open separate panes for API, frontend, and tests and coordinate their startups from a single prompt.

Quick Start

Start by ensuring you’re inside a tmux-session started by cctmux, then tell Claude to set up panes and launch your dev servers.

Frequently Asked Questions about cc-tmux

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

FAQPage Schema
How do I manage multiple tmux panes when running Claude in a dev environment?

You can manage tmux panes by using a skill that enables Claude to discover, create, and target panes within a cctmux session. This allows organized workspaces with dedicated panes for servers, watchers, and tests without losing focus.

Can Claude send commands to specific tmux panes without targeting its own pane?

Yes, pane discovery and targeting ensures safe identification of pane IDs, avoiding sending commands to Claude's own pane. It uses stable pane IDs and environment variables like CCTMUX_SESSION for session-aware command orchestration.

How do I set up separate tmux panes for API, frontend, and tests from a single prompt?

Dynamic pane creation allows Claude to spawn split panes for different services from a single prompt. Command orchestration sends keys to these panes to start processes and coordinate multi-service app startups within a single workflow.

Do I need to be inside a specific tmux session to use Claude for terminal automation?

Yes, the implementation requires running inside a tmux session started by cctmux. It relies on session-awareness through environment variables like CCTMUX_SESSION and CCTMUX_PROJECT_DIR to properly discover and manage panes.

What's the best way to orchestrate terminal sessions and monitor outputs across multiple panes?

Using a skill designed for session orchestration enables Claude to send keys to panes to start processes and monitor outputs within a single workflow. This approach provides stable pane targeting and live monitoring across multiple panes.

Why does my Claude workflow suffer from tmux pane mismanagement?

Claude workflows inside tmux often suffer from pane mismanagement and unclear orchestration. A dedicated skill solves this by providing safe pane targeting, stable pane IDs, and session-awareness through environment variables.