Comandos y opciones - Devin Docs

Uso

devin [OPTIONS] [prompt]

Puedes pasar un prompt opcional para iniciar una sesión con un mensaje inicial, o iniciarla de forma interactiva sin argumentos. También puedes consultar esta información en tu terminal con man devin.

Opciones globales

Flag	Short	Description
`--model <MODEL>`		Establece el modelo de IA para esta sesión
`--permission-mode <MODE>`		Modo de permisos (`normal`, `dangerous`, `bypass`)
`--continue`	`-c`	Reanuda la sesión más reciente en el directorio actual
`--resume <SESSION_ID>`	`-r`	Reanuda una sesión específica por ID
`--print [PROMPT]`	`-p`	Muestra la respuesta y sale (modo no interactivo). Opcionalmente, acepta un prompt inline.
`--prompt-file <FILE>`		Carga el prompt inicial desde un archivo
`--config <PATH>`		Ruta del archivo de configuración
`--export [PATH]`		Exporta la conversación a un archivo después de cada turno (formato ATIF). Usa una ruta predeterminada si no se proporciona ninguna.
`--respect-workspace-trust`		Si se deben respetar los Settings de confianza del espacio de trabajo

Ejemplos:

devin -- add a login page
devin --model opus -- refactor the auth module
devin -c                              # Reanudar la última sesión
devin -r abc12345                     # Reanudar una sesión específica
devin -p "list all TODO comments"    # Imprimir respuesta y salir
devin -p -- list all TODO comments    # Igual, usando el separador -- (también funciona)
devin --export -- fix the tests       # Exportar la conversación a la ruta predeterminada
devin --export out.json -- fix tests   # Exportar a un archivo específico

Subcomandos

devin auth

Comandos relacionados con la autenticación.

Comando	Descripción
`devin auth login`	Inicia sesión en tu cuenta
`devin auth logout`	Cierra sesión y elimina las credenciales almacenadas
`devin auth status`	Comprueba el estado de la autenticación

Opciones para devin auth login:

--force-manual-token-flow — Omite la autenticación en el navegador y pega manualmente un token (útil para sesiones remotas/SSH)

devin mcp

Conéctate e inicia sesión en servidores MCP.

Comando	Descripción
`devin mcp add <name>`	Agrega un nuevo servidor MCP
`devin mcp list`	Lista todos los servidores MCP configurados
`devin mcp get <name>`	Muestra los detalles de un servidor MCP específico
`devin mcp remove <name>`	Elimina un servidor MCP configurado
`devin mcp login <name>`	Autentícate con un servidor MCP mediante OAuth
`devin mcp logout <name>`	Elimina las credenciales de OAuth almacenadas de un servidor MCP
`devin mcp enable <name>`	Habilita un servidor MCP deshabilitado
`devin mcp disable <name>`	Deshabilita un servidor MCP sin eliminarlo

Opciones para devin mcp add:

-t, --transport <stdio|http> — Tipo de transporte (opcional; se infiere de la URL → http, de los argumentos finales → stdio)
-s, --scope <local|project|user> — Ámbito de configuración (predeterminado: local)
--url <URL> — URL para el transporte HTTP (también se puede pasar como argumento posicional después del nombre)
--command <CMD> — Comando para el transporte stdio (opcional cuando se proporcionan argumentos finales)
-e, --env <KEY=VALUE> — Variables de entorno (repetible)
-H, --header <HEADER: VALUE> — Encabezados HTTP (repetible)
--scopes <SCOPE,SCOPE> — Ámbitos de OAuth que se solicitarán (separados por comas)
--oauth-resource <RESOURCE> — Anula el parámetro resource de RFC 8707 enviado en las solicitudes de OAuth (predeterminado: la URL del servidor MCP; pasa una cadena vacía para omitirlo en proveedores que lo rechazan)
<URL> — Argumento posicional de URL para HTTP (alternativa a --url)
-- <COMMAND> [ARGS...] — Comando y argumentos para stdio (el primer argumento es el comando cuando se omite --command)

Los servidores HTTP prueban primero Streamable HTTP y, si reciben errores 4xx, recurren a SSE legacy (según la especificación de MCP). También puedes establecer \"transport\": \"sse\" explícitamente. Consulta Configuración de MCP → Solución de problemas.

Ejemplos:

# servidor stdio
devin mcp add my-server -- npx @company/mcp-server --port 3000

# servidor HTTP (URL posicional)
devin mcp add notion https://mcp.notion.com/mcp
devin mcp add --transport http datadog-mcp https://mcp.datadoghq.com/api/unstable/mcp-server/mcp

# servidor HTTP (flag --url, también funciona)
devin mcp add notion --url https://mcp.notion.com/mcp

# Con variables de entorno y ámbito
devin mcp add -e GITHUB_TOKEN=ghp_xxx github -- npx -y @modelcontextprotocol/server-github
devin mcp add -s project sentry https://mcp.sentry.dev/mcp

Opciones de devin mcp remove:

-s, --scope <local|project|user> — Ámbito de la configuración (predeterminado: local)

Opciones de devin mcp login:

--scopes <SCOPE,SCOPE> — Ámbitos de OAuth que se solicitarán (separados por comas)
--oauth-resource <RESOURCE> — Sustituye el parámetro resource de RFC 8707 enviado en las solicitudes de OAuth (predeterminado: la URL del servidor MCP; pasa una cadena vacía para omitirlo en proveedores que lo rechazan)

Opciones de devin mcp enable:

-s, --scope <local|project|user> — Ámbito de la configuración (predeterminado: local)

Opciones de devin mcp disable:

-s, --scope <local|project|user> — Ámbito de la configuración (predeterminado: local)

Consulta Configuración de MCP para más detalles.

devin rules

Gestiona las reglas del agente (blob de contexto siempre activos).

Comando	Descripción
`devin rules list`	Lista todas las reglas disponibles
`devin rules show <name>`	Muestra los detalles de una regla específica
`devin rules paths`	Muestra las ubicaciones del directorio de reglas

Opciones de devin rules list:

--provider <cursor\|windsurf> — Filtra por proveedor de reglas

Consulta Rules para más detalles.

devin skills

Gestionar las skills del agente (comandos de barra diagonal y blobs de contexto generados por el agente).

Comando	Descripción
`devin skills list`	Lista todas las skills disponibles
`devin skills show <name>`	Muestra los detalles de una skill específica
`devin skills paths`	Muestra las ubicaciones de los directorios de skills

Opciones para devin skills list:

--trigger <user\|model> — Filtrar por tipo de activador

Consulta Skills para obtener más información.

devin list

Listar las sesiones del directorio actual. Alias: devin ls

Comando	Descripción
`devin list`	Selector interactivo de sesiones (predeterminado)
`devin list --format json`	Muestra las sesiones en formato JSON
`devin list --format csv`	Muestra las sesiones en formato CSV

devin version

Muestra la versión actual y finaliza.

devin version

Esto equivale a devin --version.

devin acp

Ejecuta Devin como servidor de Agent Client Protocol (ACP) mediante stdio. Este subcomando está diseñado para que lo invoque como subproceso un editor o IDE compatible con ACP (como Windsurf o Zed): se comunica mediante JSON-RPC a través de stdin/stdout y no está pensado para usarse de forma interactiva.

devin acp

El servidor ACP lee las credenciales de WINDSURF_API_KEY si está definida; de lo contrario, usa las credenciales almacenadas por devin auth login. También puede aceptar credenciales en tiempo de ejecución mediante la solicitud authenticate de ACP.

devin update

Busca actualizaciones y, si lo deseas, instálalas.

devin update

Usa --force para reinstalar, aunque ya tengas la versión más reciente instalada:

devin update --force

devin shell

[Vista previa] Comandos de integración del shell. Consulta Integración del shell para obtener todos los detalles.

Comando	Descripción
`devin shell setup`	Instala la integración del shell en tu archivo de configuración del shell
`devin shell setup <shell>`	Instala para un shell específico (`bash`, `zsh` o `fish`)

devin sandbox

[Vista previa de investigación] Gestiona el aislamiento de procesos en sandbox a nivel del sistema operativo para la herramienta exec. Pasa la opción global --sandbox para ejecutar una sesión con el sandbox activado.

devin sandbox setup

Muestra los requisitos previos del sandbox para la plataforma actual. Requisitos para ejecutar con --sandbox:

Linux: requiere bubblewrap (bwrap) y socat. Si falta alguno de los dos, la sesión de sandbox no se iniciará y mostrará instrucciones de instalación, incluso en una distribución de WSL recién instalada.
macOS: funciona de forma nativa mediante Seatbelt; no se necesitan paquetes adicionales.
Windows: Windows nativo no puede ejecutar el sandbox. Instala WSL 2 y ejecuta Devin dentro de tu distribución de WSL.

devin sandbox setup

devin setup

Asistente interactivo para configurar la autenticación y MCP.

devin setup
devin setup --force-manual-token-flow  # Para sesiones remotas/SSH

devin uninstall

Desinstala la CLI de Devin y, opcionalmente, elimina todos los datos.

Opción	Descripción
`--clean`	Elimina todos los datos, incluida la configuración, el historial y los datos personalizados
`--force`	Omite la confirmación

Comandos de barra diagonal

Estos comandos están disponibles dentro de una sesión interactiva. Escríbelos en el prompt.

Modo y modelo

Comando	Descripción
`/mode [normal	accept-edits	plan	bypass]`	Muestra o cambia el modo actual (`autonomous` está disponible en las sesiones de sandbox)
`/normal`	Cambia al modo Normal (predeterminado)
`/accept-edits`	Cambia al modo Accept Edits (aprueba automáticamente las ediciones de archivos en el espacio de trabajo)
`/plan`	Cambia al modo Plan (planificación de solo lectura)
`/ask <question>`	Haz una pregunta sin realizar cambios en el código (oneshot)
`/bypass`	Cambia al modo Bypass (aprueba automáticamente todas las acciones)
`/model [name]`	Muestra o cambia el modelo actual
`/fast`	Cambia a SWE-1.6 Fast
`/theme [dark\|light\|terminal-dark\|terminal-light\|no-color]`	Cambia entre temas (oscuro, claro, terminal oscuro, terminal claro, sin color)

/bypass tiene los alias /yolo y /dangerous. Los tres hacen lo mismo.

Gestión de sesiones

Comando	Descripción
`/clear`	Borra el historial de la conversación e inicia una nueva sesión. Alias: `/new`
`/continue [session-id]`	Reanuda una sesión anterior
`/fork [step]`	Crea una bifurcación de la sesión actual en una nueva sesión. Opcionalmente, puedes bifurcar desde un paso específico (consulta `/steps`).
`/steps`	Lista los pasos de la conversación (úsalo con `/fork` y `/revert`)
`/revert <step>`	Revierte los cambios en los archivos a partir de un paso específico y retrocede la conversación hasta antes de ese paso
`/resume [session-id]`	Abre el selector interactivo de sesiones o reanuda una sesión específica por ID
`/ls [--all]`	Lista las sesiones recientes (solo del directorio actual de forma predeterminada). Alias: `/list-sessions`
`/rename-session <new title>`	Cambia el nombre de la sesión actual
`/rm-session <session-id>`	Elimina de forma irreversible una sesión y todos sus datos
`/export`	Muestra la información de exportación. Usa la marca `--export` de la CLI para habilitar la exportación de conversaciones.
`/exit`	Cierra la aplicación (alias: `/quit`). También puedes escribir `exit` o `quit` sin el prefijo `/`.

Espacio de trabajo

Comando	Descripción
`/workspace`	Lista los directorios del espacio de trabajo (alias: `/workspaces`)
`/add-dir <path>`	Agrega un directorio adicional al espacio de trabajo
`/undo-add-dir <path>`	Elimina un directorio del espacio de trabajo

Automatización

Comando	Descripción
`/loop <prompt>`	Ejecuta un prompt y luego revisa automáticamente el diff en un bucle
`/btw <prompt>`	Haz una pregunta rápida al margen. Ejecuta una sidechain usando el contexto actual de la conversación y muestra la respuesta en un recuadro, sin agregar la pregunta a la conversación principal.

Extensibilidad

Comando	Descripción
`/hooks`	Lista todos los hooks cargados con sus ID, tipos de evento y rutas de origen

Utilidades

Comando	Descripción
`/help`	Muestra los comandos de barra diagonal disponibles
`/shortcuts`	Explora los atajos de teclado en una lista interactiva con búsqueda, agrupada por categoría
`/bug [description]`	Reporta un bug a los desarrolladores de la CLI de Devin
`/update [--force]`	Busca e instala actualizaciones. Usa `--force` para reinstalar incluso si ya tienes la versión más reciente.
`/upgrade`	Cambia a un plan de suscripción superior
`/login`	Inicia sesión con tu cuenta
`/logout`	Elimina las credenciales almacenadas y sal
`/context`	Muestra el uso de la ventana de contexto
`/usage`	Muestra el uso estimado de créditos/ACU de la sesión, incluido el uso de aperturas previas de una sesión reanudada
`/compact`	Fuerza la compactación de la conversación

Sesiones en la nube (solo para insiders)

Comando	Descripción
`/cloud-sessions [--all]`	Abre un selector interactivo con tus sesiones recientes de cloud Devin. Usa las teclas de dirección para desplazarte, escribe para filtrar, pulsa Intro para conectarte y Esc para cancelar. Usa `--all` para ver las sesiones de toda la organización.
`/cloud-attach <session-id>`	Conéctate a una sesión de cloud Devin con renderizado completo de la TUI y entrada bidireccional.

Modos

Los modos controlan el nivel de autonomía del agente al combinar un modo de permisos con un perfil de agente.

Normal (predeterminado)
Plan
Bypass

Autonomía total para tareas complejas de programación. El agente puede leer, escribir y ejecutar comandos con las comprobaciones de permisos habituales.

Modo de permisos: Normal
Perfil: Normal
Úsalo para: Refactorización de varios archivos, implementación de funcionalidades, corrección de bugs

Alterna entre modos con /mode, o cambia directamente con /normal, /accept-edits, /plan o /bypass. Usa /ask <question> como comando puntual para hacer preguntas sin cambiar de modo.

Perfiles

Los perfiles determinan las herramientas disponibles para el agente y su comportamiento. Los perfiles se establecen automáticamente al cambiar de modo.

Perfil	Descripción	Acceso a herramientas
`normal`	Asistente de programación completo (utilizado por los modos Normal, Accept Edits y Bypass)	Todas las herramientas
`plan`	Flujo de trabajo de planificación estructurada (utilizado por el modo Plan)	Herramientas de solo lectura (grep, glob, read, todo, ask_user_question, exit_plan_mode)
`ask`	Respuesta a preguntas (utilizado por el comando `/ask`)	Herramientas de solo lectura (grep, glob, read, todo, ask_user_question)

​Uso

​Opciones globales

​Subcomandos

​devin auth

​devin mcp

​devin rules

​devin skills

​devin list

​devin version

​devin acp

​devin update

​devin shell

​devin sandbox

​devin sandbox setup

​devin setup

​devin uninstall

​Comandos de barra diagonal

​Modo y modelo

​Gestión de sesiones

​Espacio de trabajo

​Automatización

​Extensibilidad

​Utilidades

​Sesiones en la nube (solo para insiders)

​Modos

​Perfiles

Uso

Opciones globales

Subcomandos

devin auth

devin mcp

devin rules

devin skills

devin list

devin version

devin acp

devin update

devin shell

devin sandbox

devin sandbox setup

devin setup

devin uninstall

Comandos de barra diagonal

Modo y modelo

Gestión de sesiones

Espacio de trabajo

Automatización

Extensibilidad

Utilidades

Sesiones en la nube (solo para insiders)

Modos

Perfiles