English

Restore Checkpoint: tu botón de deshacer

Cursor acaba de reescribir tres archivos que no le pediste tocar. Colocó un componente en la carpeta equivocada, o "amablemente" reestructuró un layout que ya estaba bien. Tu primer instinto quizás sea empezar a deshacer los cambios manualmente, archivo por archivo. Ni eso ni volver a lanzar el prompt desde cero es necesario: cada edición de IA en Cursor crea un checkpoint, y un solo clic te devuelve exactamente a donde estabas.

Por qué esto importa más con agentes que con autocompletado

El autocompletado tradicional sugiere una línea a la vez: la aceptas o la rechazas, y el radio de impacto es mínimo. Un editor de IA agéntico es diferente: puede tocar varios archivos en un solo turno, reestructurar una carpeta, reescribir la firma de una función y cada punto que la llama y que depende de ella. Eso es lo que lo hace poderoso, y también lo que hace que un mal turno sea caro de revertir a mano. Los archivos ya están cambiados en disco en el momento en que el agente termina; no existe un estado implícito de "vista previa". Si la edición está mal, necesitas una forma explícita de revertirla.

Para eso sirven los checkpoints. No son una función aparte que tengas que habilitar; cada edición impulsada por IA en un chat de Cursor crea uno automáticamente.

Qué hace realmente restaurar

Cada checkpoint marca el estado de tus archivos en un punto específico de la conversación, normalmente justo antes de que un turno del agente hiciera cambios. Cuando restauras a un checkpoint, todo lo que se hizo después de ese punto se descarta, y tus archivos vuelven a como estaban en ese momento. Es una reversión genuina, no un simple "ocultar esto de la vista": los archivos en disco regresan a su estado anterior.

Esta es la diferencia entre restore checkpoint y simplemente pasar de largo una respuesta mala en el chat: pasar de largo no le hace nada a tus archivos, que siguen cambiados. Restaurar es la única forma de deshacer de verdad las ediciones que ya se aplicaron.

Cómo usarlo

1. Cuando un turno del agente produzca algo equivocado —la carpeta incorrecta, un layout roto, una refactorización que se pasa de la raya—, desplázate hacia arriba en el chat.
2. Encuentra el marcador de checkpoint que está justo antes de que ocurriera la mala edición.
3. Haz clic en restore checkpoint en ese marcador.
4. Confirma. Todo lo generado después de ese punto desaparece, y tus archivos se revierten para coincidir, incluidos los archivos que se crearon o eliminaron en el proceso.

Cursor también expone un control de "undo all" en algunos contextos para revertir en un solo paso el conjunto más reciente de cambios de IA, que funcionalmente es la misma red de seguridad para el último turno inmediato.

Dónde vale la pena

• Una refactorización grande que se descarrila. Si el agente inicia una reestructuración grande y toma un mal rumbo a mitad de camino, restaura al estado anterior a que empezara en lugar de intentar parchear el resultado a mano.
• Modo auto-run ("YOLO") activado. Cuando se le permite al agente ejecutar comandos y hacer ediciones sin aprobación por paso, los checkpoints son la red de seguridad que hace tolerable ese modo.
• Prompts exploratorios. Cuando no estás seguro de que un enfoque vaya a funcionar, deja que el agente lo intente. Si sale mal, restaurar no te cuesta nada.

Trampas

• Restaurar descarta todo lo posterior al checkpoint, no solo la parte que no te gustó. Si el agente hizo tres buenos cambios y uno malo en el mismo turno, restaurar los elimina todos.
• Los checkpoints no sustituyen a los commits. Viven dentro de la sesión de chat; un commit de git sigue siendo tu punto de guardado a más largo plazo una vez que estás conforme con un estado, independiente del historial del chat.
• No esperes demasiado para notar una mala edición. Cuanto más sigas lanzando prompts encima de un cambio malo, más atrás tendrás que restaurar al final, y más trabajo bueno perderás junto con él.