Premiers pas

Installez ccmux sur la machine qui exécutera vos agents. Après la configuration, créez un projet et attachez-le à sa première session.

Exigences

• macOS, Linux ou Windows via WSL2 (voir le Guide Windows sur GitHub — le Windows natif est suivi comme un TODO ouvert)
• L'un des suivants : Homebrew (macOS / Linuxbrew), curl + un shell POSIX ou Go 1.26+ pour le chemin depuis la source
• tmux et git. Homebrew installe les dépendances d'exécution ; le script de téléchargement installe uniquement les binaires ccmux. Courir ccmux setup pour vérifier les dépendances, ou utilisez make bootstrap lors de la construction à partir des sources.

Installer

Choisissez le script de téléchargement ou Homebrew. Utilisez la version source si vous souhaitez développer ccmux lui-même.

Télécharger le script

curl -fsSL https://ccmux.ai/install | sh
ccmux setup

Le script installe les fichiers binaires de la dernière version dans ~/.local/bin/. Ajoutez ce répertoire au PATH de votre shell si le programme d'installation vous y invite. Vous pouvez inspecter le script d'installation avant de l'exécuter.

L'assistant d'installation vérifie les dépendances, aide à configurer les CLI de votre agent et installe le démon en arrière-plan. Connectez-vous à l'agent de votre choix avant de démarrer une session. Pour un accès à distance, connectez également vos appareils au Tailscale.

Homebrew

brew trust --tap skzv/tap
brew install skzv/tap/ccmux
ccmux setup

Faites confiance au tap une fois par machine. Homebrew installe ccmux et ses dépendances packagées, notamment tmux, Mosh et ripgrep.

Alternative : à partir de la source

mkdir -p ~/Projects && cd ~/Projects
git clone https://github.com/skzv/ccmux.git
cd ccmux && make bootstrap

make bootstrap vérifie votre chaîne de build et propose d'installer tout ce qui manque, puis s'enchaîne dans make setup. Utilisez-le si vous souhaitez suivre main ou pirater ccmux lui-même.

Vous pouvez réexécuter l'assistant d'installation ultérieurement pour revoir votre configuration.

Première exécution

ccmux

Le TUI est lancé avec une première visite guidée. Presse ? sur n'importe quel écran pour la configuration complète des touches.

Raccourcis de touches

Votre premier projet

Dans le TUI : appuyez sur 2 pour les projets, puis n pour ouvrir le formulaire de nouveau projet. Remplissez le nom, choisissez un agent (Claude / Codex / Antigravity / Cursor / pi / Grok) et appuyez sur Enter. ccmux crée le répertoire sous projects.root et démarre immédiatement la session de l'agent.

Depuis le shell :

ccmux new my-app

Crée le répertoire et démarre la session avec votre agent par défaut. Le TUI s'ouvre automatiquement sur l'écran d'accueil où vous pouvez vous connecter avec Enter.

Voir Tutoriel 1 pour une présentation complète.

Étapes suivantes

• Gérer plusieurs sessions et détachez-le sans arrêter un agent.
• Connectez-vous depuis votre téléphone ou ajouter une autre machine.
• Connecter un client MCP pour inspecter les sessions de votre agent.
• Si l'installation échoue, exécutez ccmux doctor et suivez les guide de maintenance.

Vous avez repéré une erreur ou quelque chose de obsolète ? Modifier cette page sur GitHub.