v0.5.0 — installation en une seule commande
 ██████╗ ██████╗███╗   ███╗██╗   ██╗██╗  ██╗
██╔════╝██╔════╝████╗ ████║██║   ██║╚██╗██╔╝
██║     ██║     ██╔████╔██║██║   ██║ ╚███╔╝ 
██║     ██║     ██║╚██╔╝██║██║   ██║ ██╔██╗ 
╚██████╗╚██████╗██║ ╚═╝ ██║╚██████╔╝██╔╝ ██╗
 ╚═════╝ ╚═════╝╚═╝     ╚═╝ ╚═════╝ ╚═╝  ╚═╝

un gestionnaire de session tmux multi-appareils pour les agents de codage IA

Pilotez vos agents de programmation depuis tous vos appareils, même votre téléphone.

Gérez Claude Code, Codex, Cursor et vos autres agents de programmation dans un seul tableau de bord terminal. Repérez les sessions qui attendent votre réponse, passez d’un projet à l’autre et reconnectez-vous depuis un autre appareil via Tailscale.

Terminal
$ curl -fsSL https://ccmux.ai/install | sh
$ ccmux setup
$ ccmux
préférez Homebrew ? brew trust --tap skzv/tap && brew install skzv/tap/ccmux

Homebrewmis à jour cette minute-ci

// tableau de bord

Découvrez ce qui est en cours d'exécution. Trouvez ce dont vous avez besoin.

Cinq agents exécutés en parallèle sur quatre projets, codés par couleur par état : actif, inactif, a besoin de votre contribution. Le tableau de bord est mis à jour en direct au fur et à mesure de l'évolution de chaque session, et le panneau Appareils affiche toutes les autres machines exécutant ccmux sur votre tailnet juste à côté.

ccmux — visite guidée du tableau de bord
Visite guidée du tableau de bord ccmux : 5 sessions d'agent parallèles sur 4 projets, codées par couleur par état. Connectez-le au Claude Code, puis visitez les écrans Conversations, Notes, Agents, Paramètres et Réseau.

multi-appareils

Démarrez sur un hôte connecté, répondez depuis votre téléphone et revenez à la même session sur votre ordinateur portable.

chaque agent

Claude Code, Codex, Cursor et plus : chaque projet en choisit un et l'ensemble TUI suit.

clavier en premier

Appuyez sur Enter sur la session souhaitée. Aucun nom tmux, non --resume <hash>, pas de SSH-then-attach.

configuration guidée

Un curl, puis ccmux setup. Fonctionne sur votre filet arrière via SSH ou Mosh.

// transfert

Démarrez sur votre Mac. Continuez sur votre téléphone. Reprenez sur votre ordinateur portable.

Reconnectez-vous au travail que vous avez déjà commencé.

Démarrez une tâche sur un hôte Mac mini ou Linux toujours actif. L'agent y court pendant que vous vous déconnectez et continuez votre journée.

Votre téléphone vibre : Claude pose une question. Vous appuyez sur la notification, vous êtes joint. Vous répondez, frappez Ctrl-b d, verrouillez le téléphone.

Demain matin dans le train, vous ouvrez votre ordinateur portable, tapez ccmux et sélectionnez la session à distance pour reprendre là où vous vous étiez arrêté.

ccmux exécuté dans l'application Moshi sur un iPhone : une session ccmux en direct, la ligne d'état indiquant « accessible via Moshi » et la barre de touches à l'écran de Moshi en bas.

ccmux dans l'application Moshi, sur un téléphone

Sur votre téléphone, vous vous connectez via le Moshi app : un appui lorsqu'un agent a besoin de vous, puis un appui pour joindre l'application. Construire votre propre client ? ccmuxd expose un HTTP API.

// apparition

Apparaître de n'importe où.

Téléphonez dans la cuisine : démarrez une nouvelle session d'agent sur le Mac depuis votre bureau. Ouvrez le Projets sur n'importe quel appareil, appuyez sur n, et choisissez l'hôte : votre machine locale ou tout autre homologue exécutant ccmuxd sur votre tailnet. Le démon distant crée le répertoire et démarre l'agent ; ccmux SSH-vous attache. Vous n'avez jamais tapé ssh.

ccmux — nouveau projet sur n'importe quel appareil
Flux de nouveau projet ccmux : ouvrez l'onglet Projets, appuyez sur n, choisissez un hôte et un agent, soumettez — ccmux crée le répertoire et vous connecte à la nouvelle session.

//conversations

Chaque conversation. Un robinet.

ccmux se souvient de vos discussions passées Claude / Codex / Antigravity / Cursor / pi / Muse Code - triées par récence, prêtes à reprendre. Presse 2 pour l'écran Conversations, Enter sur celui que vous souhaitez. Le démon reprend l'agent avec le bon ID de session. Tu ne tapes pas claude --resume <hash> plus jamais.

ccmux — reprendre une conversation
Écran des conversations ccmux affichant les discussions Claude passées triées par récence. En en sélectionnant un et en appuyant sur Enter, l'agent reprend avec l'ID de session correct.

// raccourcis clavier

Choisissez une session. Appuyez sur Enter.

Tout est détectable. Frapper ? sur n'importe quel écran pour le clavier.

vous ne tapez pas

tmux attach -t c-auth-redesign
claude --resume 8f3a-91bc-...
ssh user@mac-mini -t tmux a -t c-foo

vous avez frappé

Enter sur la session souhaitée
3 pour voir les conversations passées
? pour voir la configuration du clavier

Vos sessions s'exécutent dans tmux. Utilisez le tableau de bord pour le travail quotidien et les commandes tmux chaque fois que vous en avez besoin.

//agents

Choisissez un agent pour chaque projet.

Chaque projet sélectionne son propre agent et s'en souvient. Le tableau de bord, le démon et la répartition suivent tous.

ccmux — agent de sélection
Création d'un nouveau projet dans ccmux, parcourant les agents de codage disponibles avec les touches fléchées, puis soumission pour démarrer celui sélectionné.
Claude Code
claude
Codex
codex
Antigravity
agy
Cursor
cursor-agent
Pi
pi
Grok
grok
Muse Code
muse

Stocké par projet dans .ccmux/agent. Par défaut : Claude. Définir une valeur par défaut différente dans config.toml.

// mcp

Votre agent peut appeler ccmux comme outil.

Connectez votre agent de codage au ccmux Serveur MCP pour inspecter les sessions, lire les notes de projet et vérifier l'utilisation. Le démarrage de sessions et l’envoi de frappes nécessitent un consentement explicite.

lire

  • liste_sessions
  • panneau_de lecture
  • liste_projets
  • liste_conversations
  • get_usage
  • liste_machines
  • read_note · notes_de recherche

acte (inscription)

  • spawn_session
  • spawn_bare_session
  • clés_envoi
  • kill_session

Masqué de tools/list jusqu'à ce que vous réussissiez --allow-mutate.

.mcp.json
{
  "mcpServers": {
    "ccmux": { "command": "ccmux-mcp" }
  }
}

Un agent sur votre ordinateur portable peut lire ce que fait son frère sur le Mac mini, lancer un assistant dans un autre projet, récupérer un résultat et nettoyer — sans que vous y entriez SSH. Pointez-le vers un homologue tailnet avec CCMUX_HOST=mini:7474.

// serveur de développement

Serveur de développement sur le mini, visualisé de n'importe où.

Démarrez votre application Web sur l'hôte, partagez son port avec Tailscale Serve et ouvrez l'URL HTTPS imprimée sur votre téléphone. Les deux appareils doivent être connectés à votre tailnet.

sur le mini

npm run dev
tailscale serve 3000

sur votre téléphone

Safari
→ HTTPS URL

sur l'ordinateur portable

Browser
→ same HTTPS URL

Utilisez le port imprimé par votre serveur de développement ; 3000 en est un exemple. Voir le guide de prévisualisation du téléphone pour l'installation du HTTPS et la configuration de l'hôte autorisé.

// plus

Et quelques autres choses que le ccmux gère silencieusement.

Fonctionnalités réactives qui apparaissent lorsque vous en avez besoin et restent à l'écart lorsque vous n'en avez pas besoin.

Questions courantes

Qu'est-ce que ccmux ajoute à tmux ?

tmux maintient les sessions de terminal en cours d'exécution après votre déconnexion. ccmux ajoute un tableau de bord pour les agents de codage, la navigation dans les projets, l'historique des conversations et la découverte de sessions à distance. Découvrez comment gérer plusieurs sessions.

Les agents fonctionnent-ils sur mon téléphone ?

Les agents s'exécutent sur votre Mac ou votre hôte Linux. Votre téléphone se connecte à cet hôte via un client terminal ; l'hôte doit rester éveillé et en ligne. Configurer l'accès mobile.

Ai-je besoin de Tailscale pour les sessions locales ?

Vous pouvez gérer des sessions sur une machine localement. Tailscale connecte vos appareils pour une découverte et un accès à distance. Connectez une deuxième machine.

ccmux inclut-il un abonnement AI ?

ccmux est téléchargeable gratuitement. Installez et connectez-vous séparément à l'agent de codage de votre choix ; l’abonnement de ce fournisseur ou les frais API s’appliquent toujours. Vérifiez les exigences d'installation.

Contribuez à améliorer ccmux

Vous avez trouvé un bug, une explication peu claire ou une traduction à améliorer ? Toutes les contributions sont bienvenues. Ouvrez une issue ou proposez une pull request.

// n'arrêtez jamais les expéditions.

Essayez-le sur votre ordinateur

v0.5.0 est sorti. macOS, Linux ou Windows via WSL2 — un curl et vous y êtes. Homebrew fonctionne également.