> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devin.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Comandos y opciones

> Referencia completa de argumentos de comandos, subcomandos y comandos de barra diagonal interactivos

<div id="usage">
  ## Uso
</div>

```bash theme={null}
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`.

***

<div id="global-flags">
  ## Opciones globales
</div>

| 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:**

```bash theme={null}
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
```

***

<div id="subcommands">
  ## Subcomandos
</div>

<div id="devin-auth">
  ### devin auth
</div>

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)

<div id="devin-mcp">
  ### devin mcp
</div>

Conéctate e inicia sesión en servidores de Model Context Protocol.

| 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)
* `<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`)

<Note>
  Los servidores HTTP prueban primero Streamable HTTP y, si reciben errores 4xx, recurren a SSE legacy (según la [especificación de MCP](https://spec.modelcontextprotocol.io/specification/2025-03-26/basic/transports/#backwards-compatibility)). También puedes establecer `"transport": "sse"` explícitamente. Consulta [Configuración de MCP → Solución de problemas](/es/cli/extensibility/mcp/configuration#troubleshooting).
</Note>

**Ejemplos:**

```bash theme={null}
# 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)

**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](/es/cli/extensibility/mcp/configuration) para más detalles.

<div id="devin-rules">
  ### devin rules
</div>

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](/es/cli/extensibility/rules) para más detalles.

<div id="devin-skills">
  ### devin skills
</div>

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](/es/cli/extensibility/skills/overview) para obtener más información.

<div id="devin-list">
  ### devin list
</div>

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               |

<div id="devin-version">
  ### devin version
</div>

Muestra la versión actual y finaliza.

```bash theme={null}
devin version
```

Esto equivale a `devin --version`.

<div id="devin-acp">
  ### devin acp
</div>

Ejecuta Devin como servidor de [Agent Client Protocol (ACP)](https://agentclientprotocol.com/) 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.

```bash theme={null}
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.

<div id="devin-update">
  ### devin update
</div>

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

```bash theme={null}
devin update
```

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

```bash theme={null}
devin update --force
```

<div id="devin-shell">
  ### devin shell
</div>

\[Vista previa] Comandos de integración del shell. Consulta [Integración del shell](/es/cli/shell-integration) 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`)                 |

<div id="devin-sandbox">
  ### devin sandbox
</div>

\[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.

<div id="devin-sandbox-setup">
  #### devin sandbox setup
</div>

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](https://learn.microsoft.com/windows/wsl/install) y ejecuta Devin dentro de tu distribución de WSL.

```bash theme={null}
devin sandbox setup
```

<div id="devin-setup">
  ### devin setup
</div>

Asistente interactivo para configurar la autenticación y MCP.

```bash theme={null}
devin setup
devin setup --force-manual-token-flow  # Para sesiones remotas/SSH
```

<div id="devin-uninstall">
  ### devin uninstall
</div>

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                                                                       |

***

<div id="slash-commands">
  ## Comandos de barra diagonal
</div>

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

<div id="mode-model">
  ### Modo y modelo
</div>

| 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)                           |      |           |                                                                                           |

<Note>
  `/bypass` tiene los alias `/yolo` y `/dangerous`. Los tres hacen lo mismo.
</Note>

<div id="session-management">
  ### Gestión de sesiones
</div>

| 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 `/`.                                         |

<div id="workspace">
  ### Espacio de trabajo
</div>

| 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                        |

<div id="automation">
  ### Automatización
</div>

| 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. |

<div id="extensibility">
  ### Extensibilidad
</div>

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

<div id="utilities">
  ### Utilidades
</div>

| 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                                                                          |

<div id="cloud-sessions-insiders-only">
  ### Sesiones en la nube (solo para insiders)
</div>

| 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.                                                                                                                                                       |

***

<div id="modes">
  ## Modos
</div>

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

<Tabs>
  <Tab title="Normal (predeterminado)">
    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
  </Tab>

  <Tab title="Plan">
    Solo planificación: el agente propone cambios sin aplicarlos. El acceso de solo lectura a las herramientas garantiza que no se modifique ningún código.

    * **Modo de permisos:** Normal
    * **Perfil:** Plan (herramientas de solo lectura)
    * **Úsalo para:** Diseño de arquitectura, comprender bases de código, planificar antes de implementar
  </Tab>

  <Tab title="Bypass">
    Todas las solicitudes de permiso se aprueban automáticamente. El agente ejecuta libremente sin pedir confirmación.

    * **Modo de permisos:** Dangerous
    * **Perfil:** Normal
    * **Úsalo para:** Tareas de confianza en las que las interrupciones te hacen perder tiempo

    <Warning>
      Usa el modo Bypass solo para tareas en las que confíes plenamente. Todas las llamadas a herramientas (incluidos los comandos destructivos) se aprueban automáticamente.
    </Warning>
  </Tab>
</Tabs>

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.

***

<div id="profiles">
  ## Perfiles
</div>

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)                   |