[Go to site: main page, start]
Skip to main content

Command Palette

Search for a command to run...

CLI

Uso del agente en la CLI

Modos

La CLI admite los mismos modos que el Editor. Para cambiar de modo, usa comandos con barra o la opción --mode.

Modo Plan

Usa el modo Plan para definir tu estrategia antes de programar. El agente formula preguntas aclaratorias para perfeccionar tu plan.

  • Pulsa Shift+Tab para alternar al modo Plan
  • Usa /plan para cambiar al modo Plan
  • Inicia con la opción --plan o --mode=plan

Modo Ask

Usa el modo Ask para explorar el código sin realizar cambios. El agente busca en tu base de código y proporciona respuestas sin editar archivos.

  • Usa /ask para cambiar al modo Ask
  • Inicia con la opción --mode=ask

Instrucciones

Para obtener los mejores resultados, se recomienda expresar claramente la intención. Por ejemplo, puedes usar la instrucción "no escribas código" para asegurarte de que el agente no edite ningún archivo. Esto suele ser útil al planificar tareas antes de implementarlas.

Agent cuenta con herramientas para realizar operaciones con archivos, buscar, ejecutar comandos de shell y acceder a la web.

MCP

Agent es compatible con MCP (Model Context Protocol) para ampliar sus funcionalidades e integraciones. La CLI detectará y respetará automáticamente tu archivo de configuración mcp.json, lo que permitirá usar los mismos servidores MCP y herramientas que hayas configurado en el Editor.

ACP

Agent también es compatible con ACP (Agent Client Protocol) para integraciones con clientes personalizados. Usa agent acp para ejecutar la CLI de Cursor como servidor ACP mediante stdio con mensajería JSON-RPC.

Reglas

El agente de programación de la CLI admite el mismo sistema de reglas que el Editor. Puedes crear reglas en el directorio .cursor/rules para proporcionar contexto y orientación al agente de programación. Estas reglas se cargarán y aplicarán automáticamente según su configuración, lo que te permitirá personalizar el comportamiento del agente de programación para distintas partes de tu proyecto o tipos de archivo específicos.

Trabajar con Agent

Navegación

Puede acceder a los mensajes anteriores con la flecha hacia arriba (ArrowUpArrow Up) y recorrerlos.

Atajos de entrada

  • Shift+Tab — Alterna entre los modos (Agent, Plan, Ask)
  • Shift+Enter — Inserta una nueva línea en lugar de enviar la instrucción, lo que facilita escribir instrucciones de varias líneas.
  • Ctrl+D — Sale de la CLI. Sigue el comportamiento estándar de la shell y requiere pulsarlo dos veces para salir.
  • Ctrl+J o +Enter — Alternativas universales para insertar nuevas líneas que funcionan en todos los terminales.

Revisión

Revisa los cambios con Ctrl+R. Pulsa i para añadir instrucciones de seguimiento. Usa ArrowUpArrow Up/ArrowDownArrow Down para desplazarte y ArrowLeftArrow Left/ArrowRightArrow Right para cambiar de archivo.

Seleccionar contexto

Selecciona archivos y carpetas para incluirlos en el contexto con @. Libera espacio en la ventana de contexto ejecutando /summarize. /compress sigue siendo un alias.

Transferencia a un agente en la nube

Envía tu conversación a un agente en la nube y deja que siga ejecutándose mientras no estás. Añade & al principio de cualquier mensaje para enviarlo a la nube. Retómala en la web o en móvil desde cursor.com/agents.

# Envía una tarea a Cloud Agent a mitad de la conversación& refactor the auth module and add comprehensive tests

Worktrees de CLI

Usa -w o --worktree [name] para ejecutar el agente en un nuevo worktree de Git en lugar de editar directamente el checkout actual. Cursor crea estos checkouts en ~/.cursor/worktrees/<reponame>/<name>, junto a los worktrees creados desde el Editor. Si omites name, Cursor genera uno.

Cursor limpia los worktrees de CLI según las mismas reglas de retención que aplica a los worktrees del Editor. Para consultar los ajustes y límites de limpieza, consulta ¿Cómo se limpian los worktrees antiguos?.

Usa --workspace <path> cuando necesites especificar la raíz del repositorio. De lo contrario, la CLI usa el directorio de trabajo actual. --worktree solo cambia dónde el agente realiza ediciones de archivos dentro de ese proyecto.

# Crear un worktree temporal del repositorio actual con un nombre generadoagent --worktree "upgrade the test runner and fix any broken snapshots"# Crear un worktree con nombre de otro repositorioagent --workspace ~/src/my-app --worktree auth-fix "fix the flaky auth test and open a PR"

Historial

Continúa un hilo existente con --resume [thread id] para cargar el contexto anterior.

Para reanudar la conversación más reciente, usa agent resume, --continue o el comando con barra /resume.

También puedes ejecutar agent ls para abrir chats anteriores y reanudar uno.

Aprobación de comandos

Antes de ejecutar comandos de terminal, la CLI te pedirá que apruebes (y) o rechaces (n) la ejecución.

Modo no interactivo

Usa -p o --print para ejecutar Agent en modo no interactivo. Esto imprimirá la respuesta en la consola.

El modo no interactivo te permite invocar Agent sin interacción. Así puedes integrarlo en scripts, canalizaciones de CI, etc.

Puedes combinarlo con --output-format para controlar el formato de la salida. Por ejemplo, usa --output-format json para obtener una salida estructurada más fácil de analizar en scripts, o --output-format text para obtener la respuesta final del agente como texto sin formato.