Comandi di Muse Code: il prontuario della CLI con flag, scorciatoie e slash command
Tutti i comandi di Muse Code che vale la pena conoscere in una pagina: installazione e accesso, slash command, scorciatoie da tastiera, muse exec per la CI, modalità di approvazione e --yolo, modelli e livello di ragionamento, skill, MCP e dove si trova la configurazione.
Muse Code è un programma da terminale, e il comando muse fa quasi tutto. In questa pagina abbiamo raccolto comandi, flag, slash command e scorciatoie dalla documentazione di Meta, aggiornati alla CLI 1.4.13. Digita /help in una sessione per l’elenco completo supportato dalla tua versione e /keymap per le scorciatoie.
Installare, accedere e controllare la versione
| Comando | Cosa fa |
|---|---|
curl -fsSL https://dev.meta.ai/install.sh | sh |
Installa su macOS o Linux |
irm https://dev.meta.ai/install.ps1 | iex |
Installa su Windows (PowerShell) |
muse --version |
Mostra la versione installata |
muse |
Avvia una sessione nella cartella corrente; al primo avvio ti fa accedere |
muse auth set |
Salva una chiave API invece di usare il browser |
/login |
Riapre le opzioni di accesso dall’interno di una sessione |
muse logout |
Cancella la sessione browser e la chiave salvate |
muse usage |
Mostra quanta parte della quota del piano ti resta |
/upgrade |
Apre l’Accounts Center per cambiare piano |
Muse Code si aggiorna da solo. La nostra guida all’installazione spiega aggiornamenti, risoluzione dei problemi e disinstallazione.
Slash command della sessione
| Comando | Cosa fa |
|---|---|
/help |
Elenca tutti i comandi disponibili in questo workspace |
/new |
Avvia una nuova sessione mantenendo lo scrollback del terminale |
/clear |
Avvia una nuova sessione e cancella lo scrollback |
/resume |
Sceglie una sessione precedente di questo workspace da riprendere |
/resume --last |
Riprende la sessione più recente |
/name [name] |
Mostra o imposta il nome della sessione |
/fork |
Crea una nuova sessione dall’ultimo punto stabile |
/rewind |
Riparte da un tuo messaggio precedente |
/side [prompt] o /btw <prompt> |
Apre una conversazione laterale senza far deragliare quella principale |
/compact |
Riassume il contesto precedente per liberare spazio |
/recap |
Riassume l’attività recente |
/copy |
Copia l’ultima risposta |
/export transcript |
Salva la conversazione in un file .txt |
/export trajectory |
Salva il log completo della sessione in JSON |
Pianificazione, obiettivi e agenti
| Comando | Cosa fa |
|---|---|
/plan |
Prepara un piano e aspetta la tua approvazione prima di costruire |
/grill |
Mette sotto torchio il piano finché non regge |
/goal <objective> |
Fissa un obiettivo verso cui l’agente lavora; lo gestisci con /goal pause, /goal resume, /goal edit, /goal clear |
/loop <cadence> <prompt> |
Ripete un prompt a intervalli (10m) o secondo un’espressione cron |
/workflows |
Apre la sala di controllo dei workflow multi-agente |
/subagents |
Mostra i subagenti in corso e conclusi |
/tasks |
Apre il pannello dei task in background |
/stop |
Annulla i task in background e i terminali |
L’articolo sulle skill incluse spiega come /plan, /grill e /goal lavorano insieme.
Modelli e ragionamento
| Comando o flag | Cosa fa |
|---|---|
/model <model-id> |
Cambia direttamente modello, ad esempio /model muse-wonder-1.0 |
/models |
Apre il selettore dei modelli |
/effort |
Imposta il livello di ragionamento per la sessione |
--model <id> |
Sceglie il modello all’avvio |
--reasoning-effort <level> |
none, minimal, low, medium, high (predefinito), xhigh, max o ultra |
/settings |
Impostazioni, tra cui Model → modalità Contributor sui piani |
--contributor-mode on|off |
Forza la modalità Contributor per una singola esecuzione |
I token di ragionamento si pagano come output, quindi tieni max e ultra per i problemi difficili. Impostare il livello su ultra può anche avviare da solo un workflow multi-agente.
Scorciatoie da tastiera
| Tasto | Cosa fa |
|---|---|
Enter mentre l’agente lavora |
Corregge la rotta: aggiunge il tuo testo al turno in corso |
Alt+Enter |
Mette in coda il testo per il turno successivo |
Esc |
Interrompe il turno in corso |
Esc con il prompt vuoto |
Ritira l’ultima istruzione in coda |
Esc Esc a riposo |
Torna indietro (rewind) |
Ctrl+C |
Interrompe (prompt vuoto) o cancella l’input |
Alt+V (Option+V su Mac) |
Avvia o ferma l’input vocale (non su Windows) |
Quando l’agente fa domande di chiarimento, i tasti numerici scelgono le opzioni, Space attiva o disattiva le voci nella selezione multipla, Tab aggiunge una nota e Enter conferma.
Esecuzione headless: muse exec
| Flag | Cosa fa |
|---|---|
muse exec "<prompt>" |
Esegue un task fino in fondo e poi esce |
--json |
Stampa eventi JSONL su stdout |
--prompt-file <path> |
Legge il prompt da un file |
--max-model-steps <n> |
Pone un tetto alla quantità di lavoro dell’esecuzione |
--session-id <uuid> |
Prosegue una sessione precedente in modo non interattivo |
--no-session-log |
Non conserva il log della sessione |
muse export --session <uuid> --out run.json |
Esporta una sessione |
Codici di uscita: 0 il turno si è concluso, 1 è fallito o è stato annullato (anche per aver raggiunto il limite di passi), 2 errore di utilizzo, 130/143 interrotto. Uno 0 non significa che il codice sia giusto: esegui i tuoi test. In CI autenticati con META_API_KEY; la nostra guida alla chiave API ha un esempio.
Permessi e sandbox
| Flag | Cosa fa |
|---|---|
--approval-mode on-request |
Predefinito: i comandi di shell rischiosi si fermano per la revisione |
--approval-mode untrusted |
Tutto ciò che non ha una regola di autorizzazione si ferma per la revisione |
--approval-mode never |
Nessuna richiesta di approvazione; la sandbox resta attiva |
--approval-judge off |
Passa a te ogni decisione di approvazione, invece che al giudice integrato |
--disable-approval |
Salta le approvazioni, mantiene la sandbox |
--disable-sandbox |
Mantiene le approvazioni, toglie la sandbox |
--yolo |
Niente approvazioni, niente sandbox, workspace considerato attendibile: solo per container usa e getta |
--sandbox-network <mode> |
proxy-only (predefinito), restricted o unrestricted |
--trust-workspace |
Considera attendibile la cartella senza la domanda del primo avvio |
Le sessioni partono con il profilo Auto-review; gli altri sono Ask me, Read-only e Unrestricted. La documentazione spiega cosa consente ciascuno.
Skill, MCP e configurazione del progetto
| Comando | Cosa fa |
|---|---|
muse init |
Scrive un AGENTS.md per il progetto (--dry-run per un’anteprima) |
muse skills list |
Elenca le skill installate |
muse skills install ./my-skill --scope user |
Installa una skill |
muse skills import --from claude |
Importa le skill di Claude Code (--from codex per Codex) |
/migrate |
Importa memoria e configurazione MCP di Claude Code o Codex |
/mcp |
Mostra i server e i tool MCP collegati |
muse mcp login <server> |
Accede a un server MCP remoto |
muse config status |
Mostra quali impostazioni sono effettivamente attive |
/theme |
Cambia il tema del terminale |
Dove si trovano i file
- Impostazioni:
~/.config/muse/settings.json: profilo di permessi predefinito, server MCP, hook, conservazione delle sessioni. - Istruzioni di progetto:
AGENTS.md; Muse Code legge ancheCLAUDE.md,.agents/AGENTS.mde.claude/CLAUDE.md. - Skill e memoria di progetto:
.agents/skills/e.agents/memory/nel repository. - Hook di progetto:
.muse/hooks.json, caricato solo dopo che hai considerato attendibile la cartella.
Sei nuovo di Muse Code? Comincia dalla guida introduttiva, poi tieni questa pagina aperta in una scheda.