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.