git404hub

what is ccmux fr?

epilande/ccmux — explained in plain English

Analysis updated 2026-05-18

86TypeScriptAudience · developerComplexity · 2/5Setup · easy

tl;dr

A tmux-based tool that tracks every AI coding agent session across your panes and lets you jump straight to the one that needs your attention.

vibe map

mindmap
  root((ccmux))
    What it does
      Tracks agent sessions in tmux
      Shows idle working waiting states
      Lets you jump to the right pane
    Tech stack
      TypeScript
      Bun
      tmux
    Use cases
      Multi agent session overview
      Act on notifications directly
      Review diffs and PR status
    Audience
      Developers running many agents
      tmux power users

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

See at a glance which of several AI coding agent sessions is idle, working, or waiting for approval.

VIBE 2

Jump straight to the tmux pane of the agent session that needs your attention.

VIBE 3

Approve, deny, or reply to a waiting agent directly from a desktop notification.

VIBE 4

Review a session's git diff or open pull request status without leaving the tool.

what's the stack?

TypeScriptBuntmuxClaude CodeCodex

how it stacks up fr

epilande/ccmuxpedrofariasx/deepsproxyryensx/opencodex
Stars868686
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyeasyeasymoderate
Complexity2/52/53/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · easy time til it works · 5min

Requires tmux with agent sessions already running, Bun is needed only when installing from source.

in plain english

ccmux is a command line tool for people who run several AI coding agents at once inside tmux, a terminal multiplexer that lets you split your terminal into multiple panes. If you have Claude Code, Codex, Cursor, or a similar agent running in several panes at the same time, it becomes hard to remember which one finished its work, which one is stuck waiting for you to approve something, and which one is still busy. ccmux solves that by running a background process that watches all your panes and showing you a live list of every agent session, each marked as idle, working, or waiting for a permission, plan approval, or answer. From that list, called the picker, you can jump straight into whichever session needs your attention, see a live preview of what is happening in a pane before switching to it, and even type or approve things directly from the preview without fully switching over. It also supports desktop notifications you can act on immediately, a permanently visible sidebar mode, fuzzy search across your sessions by project or branch, and awareness of git branches, worktrees, and open pull requests including their CI status. You can review a session's code changes as a diff without leaving ccmux, and spawn, restart, or kill agent sessions directly from the tool. It supports Claude Code, Codex, Cursor, OpenCode, and several other agents out of the box, with the option to add custom agent definitions through configuration. Setup mainly means installing ccmux, running its setup command to register hooks with your agents for more reliable session tracking, and starting your usual agent sessions inside tmux as before, since ccmux discovers what is already running rather than changing how you launch anything. The project is written in TypeScript, requires tmux and Bun if installing from source, and offers a Homebrew installation option as well.

prompts (copy fr)

prompt 1
Help me install ccmux with Homebrew and run ccmux setup to register agent hooks.
prompt 2
Explain how ccmux tracks whether my Claude Code or Codex sessions are idle or waiting.
prompt 3
Show me how to bind a tmux popup key to open the ccmux picker from any pane.
prompt 4
Walk me through using ccmux invoke to run a single scripted agent turn.

Frequently asked questions

what is ccmux fr?

A tmux-based tool that tracks every AI coding agent session across your panes and lets you jump straight to the one that needs your attention.

What language is ccmux written in?

Mainly TypeScript. The stack also includes TypeScript, Bun, tmux.

How hard is ccmux to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is ccmux for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.