Tres modos de Cursor CLI: Agent / Plan / Ask
Tres modos, una frase para distinguirlos: quién puede tocar tu código y quién solo puede hablar. Cuando entiendes eso, elegir el modo correcto es fácil.
Comparación en una frase
| Modo | Una frase | ¿Modifica tus archivos? |
|---|---|---|
| Agent | "Hazlo" por mí | ✅ Sí |
| Plan | "Primero planea cómo hacerlo y luego decido" | Aún no — solo tras tu aprobación |
| Ask | Solo "preguntar" o investigar | ❌ No |
Piensa en tres colegas: Agent dice "dámelo, yo lo hago"; Plan dice "te preparo propuesta y me confirmas"; Ask dice "solo respondo, no toco archivos". Elegir bien te ahorra muchos problemas.
Modo Agent (predeterminado)
Caso de uso: que la IA edite código, añada funciones o refactorice directamente. Quieres resultados, no solo discusión.
cursor agent "Change login to use JWT"- Lee y edita archivos; también puede ejecutar comandos
- Puedes aceptar o rechazar cada paso
Modo Plan
Caso de uso: no tienes claro el enfoque o te preocupa que la IA haga demasiados cambios de golpe. Primero ves el plan y luego apruebas.
cursor agent --plan "Refactor the entire API layer"- La IA hará algunas preguntas y propondrá enfoque
- Solo actúa después de tu acuerdo
Cuándo usarlo: cambios grandes o cuando quieres "verlo claro antes de tocar código".
Modo Ask (solo lectura)
Caso de uso: quieres preguntar "qué hace este código" o "hay una mejor forma de escribir esto", pero no quieres que se edite nada.
cursor ask "What is the logic in src/auth.ts?"- Solo lee, analiza y responde
- Ideal para CI o entornos de inspección
Cambiar de modo en medio de la conversación
¿Ya estás dentro de cursor agent? Usa slash commands para cambiar al instante:
/plan→ Cambiar a Plan (primero plan, luego ejecución)/ask→ Cambiar a Ask (solo lectura)
No hace falta salir y volver a entrar.
Resumen
- Agent: ejecuta y modifica archivos
- Plan: planifica primero y actúa con tu aprobación
- Ask: responde en modo read-only
Siguiente: 04-non-interactive — Modo no interactivo para scripts y CI