GUIDE· 7 min de lecture

Commandes Muse Code : l’aide-mémoire de la CLI (options, raccourcis, slash commands)

Toutes les commandes Muse Code utiles sur une seule page : installer et se connecter, slash commands, raccourcis clavier, muse exec pour la CI, modes de validation et --yolo, modèles et effort de raisonnement, skills, MCP et emplacement de la configuration.

#cli#commands#reference#getting-started

Muse Code est un programme de terminal, et la commande muse fait presque tout. Cette page rassemble les commandes, options, slash commands et raccourcis tirés de la documentation de Meta, à jour de la CLI 1.4.13. Tape /help dans une session pour voir la liste complète prise en charge par ta version, et /keymap pour les raccourcis.

Installer, se connecter et vérifier sa version

Commande Ce qu’elle fait
curl -fsSL https://dev.meta.ai/install.sh | sh Installe sous macOS ou Linux
irm https://dev.meta.ai/install.ps1 | iex Installe sous Windows (PowerShell)
muse --version Affiche la version installée
muse Démarre une session dans le dossier courant ; te connecte au premier lancement
muse auth set Enregistre une clé API au lieu de passer par le navigateur
/login Rouvre les options de connexion depuis une session
muse logout Efface la session de navigateur et la clé enregistrées
muse usage Affiche ce qu’il reste du quota de ton forfait
/upgrade Ouvre l’Accounts Center pour changer de forfait

Muse Code se met à jour tout seul. Notre guide d’installation couvre les mises à jour, le dépannage et la désinstallation.

Slash commands de session

Commande Ce qu’elle fait
/help Liste toutes les commandes disponibles dans cet espace de travail
/new Démarre une nouvelle session en conservant l’historique du terminal
/clear Démarre une nouvelle session et efface l’historique
/resume Choisit une session antérieure de cet espace de travail pour la poursuivre
/resume --last Reprend la session la plus récente
/name [name] Affiche ou définit le nom de la session
/fork Crée une nouvelle session à partir du dernier point stable
/rewind Repart de l’un de tes messages précédents
/side [prompt] ou /btw <prompt> Ouvre une conversation annexe sans dérouter la principale
/compact Résume le contexte antérieur pour libérer de la place
/recap Résume l’activité récente
/copy Copie la dernière réponse
/export transcript Enregistre la conversation dans un fichier .txt
/export trajectory Enregistre le journal complet de la session en JSON

Planification, objectifs et agents

Commande Ce qu’elle fait
/plan Produit un plan et attend ton accord avant de construire
/grill Met le plan à l’épreuve jusqu’à ce qu’il tienne la route
/goal <objective> Fixe un objectif vers lequel l’agent travaille ; /goal pause, /goal resume, /goal edit et /goal clear permettent de le gérer
/loop <cadence> <prompt> Répète un prompt à intervalle régulier (10m) ou selon une expression cron
/workflows Ouvre la salle de contrôle des workflows multi-agents
/subagents Affiche les sous-agents en cours et terminés
/tasks Ouvre le tiroir des tâches d’arrière-plan
/stop Annule les tâches d’arrière-plan et les terminaux

L’article sur les skills intégrés explique comment /plan, /grill et /goal s’articulent.

Modèles et raisonnement

Commande ou option Ce qu’elle fait
/model <model-id> Change directement de modèle, par exemple /model muse-wonder-1.0
/models Ouvre le sélecteur de modèles
/effort Règle l’effort de raisonnement pour la session
--model <id> Choisit le modèle au lancement
--reasoning-effort <level> none, minimal, low, medium, high (par défaut), xhigh, max ou ultra
/settings Paramètres, dont Model → mode Contributor sur les forfaits
--contributor-mode on|off Force le mode Contributor pour une seule exécution

Les tokens de raisonnement sont facturés comme de la sortie : garde max et ultra pour les problèmes difficiles. Régler l’effort sur ultra peut aussi déclencher de lui-même un workflow multi-agent.

Raccourcis clavier

Touche Ce qu’elle fait
Enter pendant que l’agent travaille Réoriente : ajoute ton texte au tour en cours
Alt+Enter Met le texte en file d’attente pour le tour suivant
Esc Interrompt le tour en cours
Esc sur un prompt vide Retire la dernière instruction en file d’attente
Esc Esc au repos Revient en arrière (rewind)
Ctrl+C Interrompt (prompt vide) ou efface la saisie
Alt+V (Option+V sur Mac) Active ou coupe la saisie vocale (pas sous Windows)

Quand l’agent pose des questions de clarification, les touches numériques choisissent les options, Space coche ou décoche en sélection multiple, Tab ajoute une note et Enter valide.

Exécution sans interface : muse exec

Option Ce qu’elle fait
muse exec "<prompt>" Exécute une tâche jusqu’au bout puis quitte
--json Écrit les événements JSONL sur stdout
--prompt-file <path> Lit le prompt depuis un fichier
--max-model-steps <n> Plafonne la quantité de travail de l’exécution
--session-id <uuid> Poursuit une session antérieure en mode non interactif
--no-session-log Ne conserve pas de journal de session
muse export --session <uuid> --out run.json Exporte une session

Codes de sortie : 0 le tour s’est terminé, 1 il a échoué ou a été annulé (y compris en atteignant la limite d’étapes), 2 erreur d’utilisation, 130/143 interruption. Un 0 ne signifie pas que le code est correct : lance tes tests. En CI, authentifie-toi avec META_API_KEY ; notre guide sur la clé API donne un exemple.

Permissions et sandbox

Option Ce qu’elle fait
--approval-mode on-request Par défaut : les commandes shell risquées s’arrêtent pour validation
--approval-mode untrusted Tout ce qui n’a pas de règle d’autorisation s’arrête pour validation
--approval-mode never Aucune demande de validation ; la sandbox reste active
--approval-judge off Te renvoie toutes les décisions de validation au lieu du juge intégré
--disable-approval Saute les validations, garde la sandbox
--disable-sandbox Garde les validations, retire la sandbox
--yolo Ni validations ni sandbox, espace de travail approuvé : uniquement pour des conteneurs jetables
--sandbox-network <mode> proxy-only (par défaut), restricted ou unrestricted
--trust-workspace Approuve le dossier sans la question du premier lancement

Les sessions démarrent avec le profil Auto-review ; les autres sont Ask me, Read-only et Unrestricted. La documentation détaille ce que chacun autorise.

Skills, MCP et configuration du projet

Commande Ce qu’elle fait
muse init Écrit un AGENTS.md pour le projet (--dry-run pour un aperçu)
muse skills list Liste les skills installés
muse skills install ./my-skill --scope user Installe un skill
muse skills import --from claude Importe les skills de Claude Code (--from codex pour Codex)
/migrate Importe la mémoire et la configuration MCP de Claude Code ou de Codex
/mcp Affiche les serveurs et outils MCP connectés
muse mcp login <server> Se connecte à un serveur MCP distant
muse config status Affiche les réglages effectivement appliqués
/theme Change le thème du terminal

Où se trouvent les fichiers

  • Paramètres : ~/.config/muse/settings.json : profil de permissions par défaut, serveurs MCP, hooks, durée de conservation des sessions.
  • Instructions de projet : AGENTS.md ; Muse Code lit aussi CLAUDE.md, .agents/AGENTS.md et .claude/CLAUDE.md.
  • Skills et mémoire du projet : .agents/skills/ et .agents/memory/ dans le dépôt.
  • Hooks du projet : .muse/hooks.json, chargé seulement une fois le dossier approuvé.

Tu découvres Muse Code ? Commence par la prise en main, puis garde cette page ouverte dans un onglet.

Poursuivre la lecture