ccmux

Name: ccmux
Author: epilande

Verified

🔮 Track all your AI coding agents (Claude Code, Codex, Cursor, ...) in tmux and jump to the one that needs you

54stars

3forks

TypeScript

Installation

# Add to your Claude Code skills
git clone https://github.com/epilande/ccmux

Getting Started

Guides for using ai agents skills like ccmux.

Caveman: Cut Claude Token Use by 65%
How agent-side prompt compression works, when to use it, and when not to.
What is an AI Skills Marketplace?
Definitions, how marketplaces work, and how to choose between them in 2026.
Getting Started with AI Skills

Security ReportVerified

Last scanned: 7/10/2026

{
  "issues": [
    {
      "type": "npm-audit",
      "message": "@babel/core: @babel/core: Arbitrary File Read via sourceMappingURL Comment",
      "severity": "low"
    },
    {
      "type": "npm-audit",
      "message": "@jimp/core: Vulnerability found",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "@jimp/diff: Vulnerability found",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "@jimp/js-bmp: Vulnerability found",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "@jimp/js-gif: Vulnerability found",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "@jimp/js-jpeg: Vulnerability found",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "@jimp/js-png: Vulnerability found",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "@jimp/js-tiff: Vulnerability found",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "@jimp/plugin-blur: Vulnerability found",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "@jimp/plugin-color: Vulnerability found",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "@jimp/plugin-contain: Vulnerability found",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "@jimp/plugin-cover: Vulnerability found",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "@jimp/plugin-crop: Vulnerability found",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "@jimp/plugin-hash: Vulnerability found",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "@jimp/plugin-print: Vulnerability found",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "@jimp/plugin-resize: Vulnerability found",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "@jimp/plugin-rotate: Vulnerability found",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "@jimp/plugin-threshold: Vulnerability found",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "@opentui/core: Vulnerability found",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "@opentui/solid: Vulnerability found",
      "severity": "low"
    },
    {
      "type": "npm-audit",
      "message": "diff: jsdiff has a Denial of Service vulnerability in parsePatch and applyPatch",
      "severity": "low"
    },
    {
      "type": "npm-audit",
      "message": "file-type: file-type affected by infinite loop in ASF parser on malformed input with zero-size sub-header",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "jimp: Vulnerability found",
      "severity": "medium"
    },
    {
      "file": "AGENTS.md",
      "line": 150,
      "type": "dangerous-command",
      "message": "Dangerous command (disables permission prompts): \"bypassPermissions\"",
      "severity": "medium"
    }
  ],
  "status": "PASSED",
  "scannedAt": "2026-07-10T07:36:14.093Z",
  "npmAuditRan": true,
  "pipAuditRan": true,
  "promptInjectionRan": true
}

README.md

Frequently Asked Questions

What is ccmux?

ccmux is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by epilande. 🔮 Track all your AI coding agents (Claude Code, Codex, Cursor, ...) in tmux and jump to the one that needs you. It has 54 GitHub stars.

Is ccmux safe to use?

Yes. ccmux passed SkillsLLM's automated security scan — a dependency vulnerability audit plus prompt-injection heuristics — with no high-severity issues. You can read the full report in the Security Report section on this page.

How do I install ccmux?

Clone the repository with "git clone https://github.com/epilande/ccmux" and add it to your Claude Code skills directory (see the Installation section above).

What programming language is ccmux written in?

ccmux is primarily written in TypeScript. It is open-source under epilande on GitHub, so you can review or fork the full source.

Are there alternatives to ccmux?

Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh ccmux against similar tools.

Agentic AI for Beginners

Build your first AI agent from scratch - tool use, ReAct pattern, memory, deployment

41 minBeginner

Comments (0)

to leave a comment.

No comments yet. Be the first to share your thoughts!

Related Skills

superpowers

by obra

An agentic skills framework & software development methodology that works.

234,966

cc-pocket seo-geo-claude-skills

❓ Why?

When running multiple AI coding agent sessions across tmux panes, it's hard to keep track of which session is idle, which is waiting for permission, and which pane to switch to. ccmux solves this with a background daemon that monitors session activity and an interactive TUI that shows live session states at a glance.

It works with your existing tmux workflow. You don't change how you launch or run your agents; ccmux discovers what's already running in your panes, so as long as you're in tmux with a supported agent, it just works.

Built-in support for: Claude Code, Codex, Cursor, OpenCode, Pi, Gemini CLI, plus custom agent definitions via config.

✨ Features

🎯 Live Session States: Every agent tracked as idle, working, or waiting (permission / plan approval / question), flagged the moment one needs you
🧩 Multi-Agent: Claude Code, Codex, Cursor, OpenCode, Pi, Gemini CLI, plus custom agents via config
🔄 Real-Time: Background daemon streams state changes instantly over SSE, no polling, no refresh
👁️ Live Preview: Split-pane view of the selected session's pane content
⚡ Act in Place: Tab into the preview to approve, answer, or type, keys go straight to that pane
📊 Sidebar Mode: Compact always-visible session rail docked beside your working panes
🔍 Fuzzy Search: Fuzzy-match sessions by project, branch, or path; substring-match any recent prompt, captured pane content, and on-demand live transcripts
📂 Session Grouping: Collapsible project groups with reordering and pinning
🌿 Git & PR Aware: Branch and worktree detection, open PRs with live CI and review status
📝 Diff Review: Press d to review a session's working-tree diff with hunk, right in the pane
🤖 Background Agents & Subagents: Claude Code background agents get rows too; nested Task agent waiting states surface
🔁 Session Control: Spawn, kill, and restart sessions from the TUI; ccmux invoke for scripted one-shot agent turns
⌨️ Keyboard-First, Mouse-Friendly: Vim keys and number jumps, plus click-to-switch and right-click context actions

📦 Installation

Prerequisites

tmux with active sessions running AI coding agents

Homebrew

brew install epilande/tap/ccmux
ccmux setup

From Source

Requires Bun.

git clone https://github.com/epilande/ccmux.git
cd ccmux
bun install
bun link
ccmux setup

ccmux setup installs agent hooks for authoritative session matching. ccmux works without it, but it's recommended; see Session Matching with Hooks. Bare ccmux setup only configures agents whose executable is found on PATH; use ccmux setup --agent <name> to install for a specific agent even if it isn't detected.

🚀 Quick Start

Start your AI coding sessions in tmux panes as usual
Launch the picker:
```
ccmux
```
Navigate with j/k, press Enter to switch to a session

[!TIP] Bind a tmux key so you can pop ccmux open from anywhere (add to ~/.tmux.conf):
# Prefix + C-p: open ccmux in a centered popup
bind-key C-p display-popup -E -w 80% -h 75% "ccmux"

# Or skip the prefix entirely (Alt+p from any pane)
bind-key -n M-p display-popup -E -w 80% -h 75% "ccmux"
The picker exits after you select a session, so the popup closes itself and drops you straight into that pane. (display-popup requires tmux 3.2+.)

🎮 Usage

CLI Commands

Command	Description
`ccmux`	Launch interactive TUI picker (default)
`ccmux picker`	Launch TUI with options (`--preview`, `--icons <style>`)
`ccmux picker --persistent`	Dashboard mode (stay open after switching sessions)
`ccmux spawn [agent]`	Spawn a new agent session in a tmux pane
`ccmux invoke [agent] "prompt"`	Run a single agent turn and write the response to stdout (docs)
`ccmux invoke list`	List active and recently-finished invocations (`-j` for JSON)
`ccmux invoke cancel <id>`	Cancel a running invocation by id (idempotent)
`ccmux invoke result <id>`	Print an invocation's full captured output (subprocess agents only)
`ccmux show`	List all active sessions
`ccmux show --json`	Output sessions as JSON
`ccmux status`	Show daemon and session overview
`ccmux switch <id>`	Switch tmux client to a session's pane
`ccmux review [id]`	Review a session's diff with hunk (defaults to cwd)
`ccmux kill <id>`	Kill a session's process
`ccmux restart <id>`	Kill and resume a session
`ccmux send <id> <text>`	Send text to a session's tmux pane (multiline pastes as one message; `--no-enter` skips submit)
`ccmux screen [id]`	Capture pane content
`ccmux screen --grep <pattern>`	Search across all session panes
`ccmux dismiss <id>`	Remove a session from tracking
`ccmux daemon start\|stop\|restart\|status`	Manage the background daemon
`ccmux config set <key> <value>`	Set a preference
`ccmux config get <key>`	Get a single preference value
`ccmux config list`	List all preferences
`ccmux config themes`	List built-in themes (marks the active one)
`ccmux setup`	Install hooks for every supported agent found on PATH (Claude + Codex + Cursor + OpenCode + Pi)
`ccmux setup --agent <name>`	Limit install/uninstall/status to specific agent(s); forces install even if not found on PATH
`ccmux setup --status`	Report install state without writing anything
`ccmux setup --uninstall`	Remove hooks (preserves user-owned hook entries)
`ccmux debug`	Diagnose session tracking discrepancies
`ccmux sidebar`	Launch narrow sidebar TUI (no preview/footer)
`ccmux sidebar --toggle`	Smart toggle: spawn/kill sidebars in every window across all tmux sessions

The daemon starts automatically the first time you run a ccmux command (picker, show, invoke, etc.). It runs on 127.0.0.1:2269 and provides both a REST API and SSE event stream.

Preview Pane

Press P to split the picker and preview the highlighted session's live pane content side by side. Press Tab to focus the preview and act in place: your keystrokes go straight to that agent's pane, so you can approve a permission, answer a question, or type a follow-up without ever leaving ccmux.

https://github.com/user-attachments/assets/7e0d42b3-4e7b-43b8-8d06-72a2d69dd694

Diff Review with Hunk

hunk is a terminal diff reviewer. With hunk on your PATH, press d in the picker to review the selected session's working-tree diff without leaving ccmux: the picker suspends, hunk diff --watch takes over the pane in the session's repository root, and the picker resumes when hunk exits. The s