Comandos do Muse Code: guia rápido da CLI com flags e atalhos de teclado
Todos os comandos do Muse Code que valem a pena conhecer numa página só: instalar e fazer login, comandos de barra, atalhos de teclado, muse exec para CI, modos de aprovação e --yolo, modelos e nível de raciocínio, skills, MCP e onde fica a configuração.
O Muse Code é um programa de terminal, e quase tudo passa pelo comando muse. Esta página reúne os comandos, flags, comandos de barra e atalhos da documentação da Meta na versão 1.4.13 da CLI. Digite /help numa sessão para ver a lista completa que a sua versão suporta, e /keymap para os atalhos.
Instalar, fazer login e conferir a versão
| Comando | O que faz |
|---|---|
curl -fsSL https://dev.meta.ai/install.sh | sh |
Instala no macOS ou Linux |
irm https://dev.meta.ai/install.ps1 | iex |
Instala no Windows (PowerShell) |
muse --version |
Mostra a versão instalada |
muse |
Abre uma sessão no diretório atual; na primeira vez, pede login |
muse auth set |
Salva uma chave de API em vez de usar o navegador |
/login |
Reabre as opções de login de dentro de uma sessão |
muse logout |
Apaga a sessão de navegador e a chave salvas |
muse usage |
Mostra quanto ainda resta da cota do seu plano |
/upgrade |
Abre o Accounts Center para trocar de plano |
O Muse Code se atualiza sozinho. Nosso guia para instalar o Muse Code explica como atualizar, resolver problemas e desinstalar.
Comandos de barra da sessão
| Comando | O que faz |
|---|---|
/help |
Lista todos os comandos disponíveis neste workspace |
/new |
Começa uma sessão nova, mantendo o histórico do terminal |
/clear |
Começa uma sessão nova e limpa o histórico |
/resume |
Escolhe uma sessão anterior deste workspace para continuar |
/resume --last |
Continua a sessão mais recente |
/name [name] |
Mostra ou define o nome da sessão |
/fork |
Cria uma nova sessão a partir do último ponto estável |
/rewind |
Ramifica a partir de uma mensagem sua anterior |
/side [prompt] ou /btw <prompt> |
Abre uma conversa paralela sem desviar a principal |
/compact |
Resume o contexto anterior para liberar espaço |
/recap |
Resume a atividade recente |
/copy |
Copia a última resposta |
/export transcript |
Salva a conversa num arquivo .txt |
/export trajectory |
Salva o log completo da sessão em JSON |
Planejamento, objetivos e agentes
| Comando | O que faz |
|---|---|
/plan |
Gera um plano e espera a sua aprovação antes de construir |
/grill |
Testa o plano sob pressão até ele se sustentar |
/goal <objective> |
Define um objetivo para o agente perseguir; /goal pause, /goal resume, /goal edit e /goal clear gerenciam o objetivo |
/loop <cadence> <prompt> |
Repete um prompt num intervalo (10m) ou numa expressão cron |
/workflows |
Abre a sala de controle das execuções de workflows multiagente |
/subagents |
Mostra os subagentes em execução e os concluídos |
/tasks |
Abre a gaveta de tarefas em segundo plano |
/stop |
Cancela tarefas e terminais em segundo plano |
O post sobre as skills incluídas explica como /plan, /grill e /goal se encaixam.
Modelos e raciocínio
| Comando ou flag | O que faz |
|---|---|
/model <model-id> |
Troca de modelo diretamente, por exemplo /model muse-wonder-1.0 |
/models |
Abre o seletor de modelos |
/effort |
Define o nível de raciocínio da sessão |
--model <id> |
Escolhe o modelo ao iniciar |
--reasoning-effort <level> |
none, minimal, low, medium, high (padrão), xhigh, max ou ultra |
/settings |
Configurações, incluindo Model → modo Contributor nos planos |
--contributor-mode on|off |
Sobrescreve o modo Contributor numa única execução |
Tokens de raciocínio são cobrados como saída, então guarde max e ultra para os problemas difíceis. Colocar o nível em ultra também pode iniciar sozinho um workflow multiagente.
Atalhos de teclado
| Tecla | O que faz |
|---|---|
Enter enquanto o agente trabalha |
Redireciona: adiciona o seu texto ao turno em andamento |
Alt+Enter |
Coloca o texto na fila para o próximo turno |
Esc |
Interrompe o turno atual |
Esc com o prompt vazio |
Retira a última instrução da fila |
Esc Esc quando ocioso |
Volta atrás (rewind) |
Ctrl+C |
Interrompe (prompt vazio) ou limpa o que foi digitado |
Alt+V (Option+V no Mac) |
Liga ou desliga a entrada por voz (não funciona no Windows) |
Quando o agente faz perguntas de esclarecimento, as teclas numéricas escolhem as opções, Space marca e desmarca na seleção múltipla, Tab adiciona uma observação e Enter envia.
Rodando sem interface: muse exec
| Flag | O que faz |
|---|---|
muse exec "<prompt>" |
Executa uma tarefa até o fim e sai |
--json |
Imprime eventos JSONL no stdout |
--prompt-file <path> |
Lê o prompt de um arquivo |
--max-model-steps <n> |
Limita quanto trabalho a execução pode fazer |
--session-id <uuid> |
Continua uma sessão anterior sem interação |
--no-session-log |
Não guarda log da sessão |
muse export --session <uuid> --out run.json |
Exporta uma sessão |
Códigos de saída: 0 o turno foi concluído, 1 falhou ou foi cancelado (inclusive ao bater no limite de passos), 2 erro de uso, 130/143 interrompido. Um 0 não quer dizer que o código está certo: rode os seus testes. No CI, autentique com META_API_KEY; o nosso guia da chave de API tem um exemplo.
Permissões e sandbox
| Flag | O que faz |
|---|---|
--approval-mode on-request |
Padrão: comandos de shell arriscados param para revisão |
--approval-mode untrusted |
Tudo o que não tem regra de permissão para para revisão |
--approval-mode never |
Sem pedidos de aprovação; o sandbox continua valendo |
--approval-judge off |
Manda todas as decisões de aprovação para você, e não para o juiz embutido |
--disable-approval |
Pula as aprovações e mantém o sandbox |
--disable-sandbox |
Mantém as aprovações e tira o sandbox |
--yolo |
Sem aprovações, sem sandbox e com o workspace confiável; só para containers descartáveis |
--sandbox-network <mode> |
proxy-only (padrão), restricted ou unrestricted |
--trust-workspace |
Marca a pasta como confiável sem a pergunta da primeira execução |
As sessões começam no perfil Auto-review; os outros são Ask me, Read-only e Unrestricted. A documentação explica o que cada um permite.
Skills, MCP e configuração do projeto
| Comando | O que faz |
|---|---|
muse init |
Gera um AGENTS.md para o projeto (--dry-run para pré-visualizar) |
muse skills list |
Lista as skills instaladas |
muse skills install ./my-skill --scope user |
Instala uma skill |
muse skills import --from claude |
Importa skills do Claude Code (--from codex para o Codex) |
/migrate |
Importa a memória e a configuração MCP do Claude Code ou do Codex |
/mcp |
Mostra os servidores MCP conectados e as ferramentas |
muse mcp login <server> |
Faz login num servidor MCP remoto |
muse config status |
Mostra quais configurações estão valendo |
/theme |
Troca o tema do terminal |
Onde fica cada coisa
- Configurações:
~/.config/muse/settings.json: perfil de permissão padrão, servidores MCP, hooks e retenção de sessões. - Instruções do projeto:
AGENTS.md; o Muse Code também lêCLAUDE.md,.agents/AGENTS.mde.claude/CLAUDE.md. - Skills e memória do projeto:
.agents/skills/e.agents/memory/no repositório. - Hooks do projeto:
.muse/hooks.json, carregado só depois que você marca a pasta como confiável.
Novo no Muse Code? Comece pelo guia de primeiros passos e deixe esta página aberta numa aba.