Tutoriel 1 : Votre premier projet

La boucle principale : créer un projet → démarrage de la session d'agent → attacher → travailler → détacher.

Création d'un nouveau projet dans ccmux : écran Projets → n → remplir le formulaire → démarrage de session

1. Créez un projet dans le TUI

Ouvrez ccmux :

ccmux

Appuyez sur 2 pour accéder à l'écran Projets, puis n pour ouvrir le formulaire de nouveau projet.

Remplissez :

Nom — le nom du répertoire du projet (par ex. api-service)
Hôte — sur quelle machine l'exécuter (par défaut en local)
Agent — Claude, Codex, Antigravity, Cursor, pi ou Grok ; utiliser ←/→ pour faire un cycle

Appuyez sur Enter pour créer le répertoire et démarrer la session. ccmux revient à l'écran d'accueil où la nouvelle session apparaît immédiatement.

Raccourci CLI. Si vous préférez la ligne de commande :
ccmux new api-service
Même résultat — répertoire créé sous projects.root, session tmux démarrée avec l'agent par défaut (ou celui stocké dans <project>/.ccmux/agent).

2. Joindre à la session

Sur l'écran d'accueil, accédez à la session avec j / k et appuyez sur Enter à joindre.

Vous êtes maintenant dans la session tmux exécutant votre agent. Lorsque vous avez terminé :

Ctrl-b d — détacher ; ccmux TUI reprend automatiquement
La session continue de s'exécuter en arrière-plan

3. Vérifiez l'état sans pièce jointe

Vous pouvez lire l’état de la session depuis le tableau de bord sans interrompre l’agent. Le needs_input L'indicateur (rouge) est celui à surveiller — cela signifie que l'agent attend votre réponse.

Pour lister les sessions depuis le shell :

ccmux list

4. Notes de projet

Appuyez sur 4 dans le TUI pour ouvrir le Notes onglet pour ce projet. Chaque .md le fichier dans l'arborescence du projet apparaît dans une liste regroupée par dossiers ; en sélectionner un le rend avec Glamour.

Appuyez sur / pour rechercher dans toutes les notes avec ripgrep.

Le détachement laisse la session en cours d'exécution dans tmux pendant que l'hôte reste éveillé. La protection de veille macOS par défaut fonctionne sur secteur et ne remplace pas la veille par fermeture du couvercle. Passez en revue le paramètres de veille avant de laisser un ordinateur portable sans surveillance.

Tutoriel suivant

Sessions multiples

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.

Contribuer à ccmux Améliorer le site ou les traductions

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