Comandos de Muse Code: guía rápida de la CLI, flags y atajos de teclado
Todos los comandos de Muse Code que vale la pena conocer en una sola página: instalar e iniciar sesión, comandos slash, atajos de teclado, muse exec para CI, modos de aprobación y --yolo, modelos y nivel de razonamiento, skills, MCP y dónde está la configuración.
Muse Code es un programa de terminal, y casi todo pasa por el comando muse. Aquí reunimos los comandos, flags, comandos slash y atajos que recoge la documentación de Meta a fecha de la CLI 1.4.13. Escribe /help dentro de una sesión para ver la lista completa que admite tu versión, y /keymap para los atajos.
Instalar, iniciar sesión y ver la versión
| Comando | Para qué sirve |
|---|---|
curl -fsSL https://dev.meta.ai/install.sh | sh |
Instalar en macOS o Linux |
irm https://dev.meta.ai/install.ps1 | iex |
Instalar en Windows (PowerShell) |
muse --version |
Ver la versión instalada |
muse |
Abrir una sesión en el directorio actual; la primera vez te pide iniciar sesión |
muse auth set |
Guardar una clave API en lugar de usar el navegador |
/login |
Volver a abrir las opciones de inicio de sesión desde una sesión |
muse logout |
Borrar la sesión de navegador y la clave guardadas |
muse usage |
Ver cuánto te queda de la asignación de tu plan |
/upgrade |
Abrir Accounts Center para cambiar de plan |
Muse Code se actualiza solo. Nuestra guía para instalar Muse Code explica cómo actualizar, solucionar problemas y desinstalar.
Comandos slash de la sesión
| Comando | Para qué sirve |
|---|---|
/help |
Listar todos los comandos disponibles en este workspace |
/new |
Empezar una sesión nueva conservando el historial de la terminal |
/clear |
Empezar una sesión nueva y borrar el historial |
/resume |
Elegir una sesión anterior de este workspace para continuarla |
/resume --last |
Continuar la sesión más reciente |
/name [name] |
Ver o poner el nombre de la sesión |
/fork |
Crear una sesión nueva a partir del último punto estable |
/rewind |
Ramificar desde uno de tus mensajes anteriores |
/side [prompt] o /btw <prompt> |
Abrir una conversación paralela sin desviar la principal |
/compact |
Resumir el contexto anterior para liberar espacio |
/recap |
Resumir la actividad reciente |
/copy |
Copiar la última respuesta |
/export transcript |
Guardar la conversación en un archivo .txt |
/export trajectory |
Guardar el registro completo de la sesión en JSON |
Planificación, objetivos y agentes
| Comando | Para qué sirve |
|---|---|
/plan |
Elaborar un plan y esperar tu aprobación antes de construir |
/grill |
Poner el plan a prueba hasta que se sostenga |
/goal <objective> |
Fijar un objetivo hacia el que trabaja el agente; se gestiona con /goal pause, /goal resume, /goal edit y /goal clear |
/loop <cadence> <prompt> |
Repetir un prompt cada cierto intervalo (10m) o según una expresión cron |
/workflows |
Abrir la sala de control de los workflows multiagente |
/subagents |
Ver los subagentes en marcha y los terminados |
/tasks |
Abrir el panel de tareas en segundo plano |
/stop |
Cancelar las tareas y terminales en segundo plano |
En el artículo sobre las skills incluidas explicamos cómo encajan /plan, /grill y /goal.
Modelos y razonamiento
| Comando o flag | Para qué sirve |
|---|---|
/model <model-id> |
Cambiar de modelo directamente, p. ej. /model muse-wonder-1.0 |
/models |
Abrir el selector de modelos |
/effort |
Fijar el nivel de razonamiento de la sesión |
--model <id> |
Elegir el modelo al arrancar |
--reasoning-effort <level> |
none, minimal, low, medium, high (por defecto), xhigh, max o ultra |
/settings |
Ajustes, incluido Model → modo Contributor en los planes |
--contributor-mode on|off |
Forzar el modo Contributor para una sola ejecución |
Los tokens de razonamiento se cobran como salida, así que deja max y ultra para los problemas difíciles. Además, poner el nivel en ultra puede lanzar por sí solo un workflow multiagente.
Atajos de teclado
| Tecla | Para qué sirve |
|---|---|
Enter mientras el agente trabaja |
Reconducir: añade tu texto al turno en curso |
Alt+Enter |
Dejar texto en cola para el siguiente turno |
Esc |
Interrumpir el turno actual |
Esc con el prompt vacío |
Retirar la última instrucción en cola |
Esc Esc en reposo |
Rebobinar |
Ctrl+C |
Interrumpir (prompt vacío) o borrar lo escrito |
Alt+V (Option+V en Mac) |
Activar o desactivar la entrada por voz (no disponible en Windows) |
Cuando el agente te hace preguntas para aclarar algo, las teclas numéricas eligen opciones, Space marca o desmarca en la selección múltiple, Tab añade una nota y Enter envía.
Ejecución sin interfaz: muse exec
| Flag | Para qué sirve |
|---|---|
muse exec "<prompt>" |
Ejecutar una tarea de principio a fin y salir |
--json |
Emitir eventos JSONL por stdout |
--prompt-file <path> |
Leer el prompt desde un archivo |
--max-model-steps <n> |
Limitar cuánto trabajo puede hacer la ejecución |
--session-id <uuid> |
Continuar una sesión anterior sin interacción |
--no-session-log |
No guardar registro de la sesión |
muse export --session <uuid> --out run.json |
Exportar una sesión |
Códigos de salida: 0 el turno se completó, 1 falló o se canceló (también al llegar al límite de pasos), 2 error de uso, 130/143 interrumpido. Un 0 no significa que el código esté bien: pasa tus tests. En CI, autentícate con META_API_KEY; en nuestra guía de la clave API hay un ejemplo.
Permisos y sandbox
| Flag | Para qué sirve |
|---|---|
--approval-mode on-request |
Por defecto: los comandos de shell arriesgados se detienen para revisión |
--approval-mode untrusted |
Todo lo que no tenga una regla de permiso se detiene para revisión |
--approval-mode never |
Sin peticiones de aprobación; el sandbox sigue activo |
--approval-judge off |
Que todas las decisiones de aprobación te lleguen a ti y no al juez integrado |
--disable-approval |
Saltarse las aprobaciones y mantener el sandbox |
--disable-sandbox |
Mantener las aprobaciones y quitar el sandbox |
--yolo |
Sin aprobaciones, sin sandbox y con el workspace de confianza; solo para contenedores desechables |
--sandbox-network <mode> |
proxy-only (por defecto), restricted o unrestricted |
--trust-workspace |
Marcar la carpeta como de confianza sin la pregunta del primer arranque |
Las sesiones empiezan con el perfil Auto-review; los demás son Ask me, Read-only y Unrestricted. La documentación explica qué permite cada uno.
Skills, MCP y configuración del proyecto
| Comando | Para qué sirve |
|---|---|
muse init |
Generar un AGENTS.md para el proyecto (--dry-run para previsualizar) |
muse skills list |
Listar las skills instaladas |
muse skills install ./my-skill --scope user |
Instalar una skill |
muse skills import --from claude |
Importar las skills de Claude Code (--from codex para Codex) |
/migrate |
Importar la memoria y la configuración MCP de Claude Code o Codex |
/mcp |
Ver los servidores MCP conectados y sus herramientas |
muse mcp login <server> |
Iniciar sesión en un servidor MCP remoto |
muse config status |
Ver qué ajustes están en vigor |
/theme |
Cambiar el tema de la terminal |
Dónde está cada cosa
- Ajustes:
~/.config/muse/settings.json: perfil de permisos por defecto, servidores MCP, hooks y retención de sesiones. - Instrucciones del proyecto:
AGENTS.md; Muse Code también leeCLAUDE.md,.agents/AGENTS.mdy.claude/CLAUDE.md. - Skills y memoria del proyecto:
.agents/skills/y.agents/memory/dentro del repositorio. - Hooks del proyecto:
.muse/hooks.json, que solo se cargan después de marcar la carpeta como de confianza.
¿Acabas de llegar a Muse Code? Empieza por la guía de primeros pasos y deja esta página abierta en una pestaña.