Deshacer para IA: Por qué creamos el versionado de archivos

El problema de darle a la IA un bolígrafo

Aquí hay algo que nadie te dice sobre los agentes de IA autónomos: son escritores prolíficos sin concepto de “¿estás seguro?”

Un agente de IA al que se le pide “mejorar este documento” reescribirá todo. Un agente al que se le pide “limpiar este código” reestructurará cada archivo que toque. Un agente que ejecuta una tarea en segundo plano creará, modificará y eliminará archivos sin pedir permiso, porque le dijiste que funcionara de manera autónoma.

La mayoría de las veces, los resultados son buenos. Pero “la mayoría de las veces” no es suficiente cuando la alternativa es perder trabajo que no puedes recuperar.

Por eso construimos la versionado de archivos. Cada cambio en cada archivo en cada espacio de trabajo se preserva. Cada versión se puede explorar, comparar y restaurar con un solo clic.

Es Ctrl+Z para la IA.

10 de febrero de 2026: el commit que cambió todo

El mensaje del commit dice: “feat: agregar versionado de archivos VFS con historial, restaurar y retroceso de tareas.”

Detrás de ese mensaje hay un sistema que cambió fundamentalmente la relación entre los usuarios y sus agentes de IA. Antes del versionado, dar acceso de escritura a un agente de IA a tus archivos requería confianza. Después del versionado, no requiere nada, porque cualquier cambio se puede deshacer.

Esto importa más de lo que podrías pensar.

Por qué los agentes de IA necesitan control de versiones

La edición de archivos humana es deliberada. Abres un archivo, haces cambios, guardas. Si no te gusta el resultado, deshaces. El bucle cognitivo es estrecho: cambiar, evaluar, mantener o revertir.

La edición de archivos por parte de un agente de IA es diferente. El agente puede modificar cinco archivos en una tarea. Puede ejecutar un trabajo en segundo plano que toque archivos mientras duermes. Puede interpretar “actualizar el informe” como “reescribir el informe desde cero.”

Sin versionado, cada operación de archivo de IA es una puerta de un solo sentido. El original se ha ido. Si no te gusta el resultado, tienes que reconstruir manualmente lo que había antes, suponiendo que lo recuerdes.

Con el versionado, cada operación de archivo de IA es reversible. El original se preserva. Si no te gusta el resultado, haces clic en “restaurar” y vuelve en menos de un segundo.

Cómo funciona

Instantáneas automáticas. Cada vez que se guarda un archivo —por ti, por un agente de IA, por una tarea en segundo plano, por una carga de archivo— la versión anterior se captura automáticamente. No se requiere acción manual. No hay paso de “recuerda hacer commit”. Cada guardado crea historia.

Navegador de historial de versiones. Abre cualquier archivo y ve su historial completo. Cada versión tiene una marca de tiempo y contexto: quién lo cambió (usuario vs. agente vs. tarea en segundo plano), cuándo y desde qué sesión. Puedes ver la línea de tiempo completa de la evolución de un archivo.

Restauración con un clic. Encuentra la versión que deseas. Haz clic en restaurar. El archivo vuelve inmediatamente. La restauración en sí crea una nueva versión (el estado actual antes de la restauración se preserva), por lo que restaurar también es reversible.

Retroceso de tareas. Esta es la función de la que estamos más orgullosos. Cuando una tarea en segundo plano modifica archivos, todas esas modificaciones se etiquetan con el ID de la tarea. Si la tarea produjo malos resultados, puedes revertir todos los archivos que tocó a su estado anterior a la tarea con una sola acción. No archivo por archivo, sino todo de una vez.

El detalle de implementación que importa

Las instantáneas se toman utilizando un patrón decorador. El proveedor de almacenamiento se envuelve con un VersionedStorageProvider que intercepta cada operación de escritura y crea una instantánea antes de que se complete la escritura.

Esto significa que el versionado es invisible para el resto del sistema. El agente de IA no sabe que los archivos están siendo versionados. El punto de carga no sabe que los archivos están siendo versionados. El motor de tareas en segundo plano no sabe que los archivos están siendo versionados. Todos simplemente escriben archivos normalmente, y la capa de versionado captura todo.

Esta fue una elección de diseño deliberada. No queríamos que el versionado fuera una función que los desarrolladores tuvieran que recordar usar. Queríamos que fuera una propiedad del propio sistema de archivos. Cada archivo está versionado. Siempre. No se requiere optar por ello.

La ecuación de confianza

Antes del versionado, había una ecuación de confianza implícita cada vez que un usuario ejecutaba un agente de IA:

¿Vale la pena el beneficio de esta tarea frente al riesgo de que el agente estropee mis archivos?

Para archivos importantes —un informe cuidadosamente redactado, una base de código funcional, un conjunto de datos curado— la respuesta a menudo era “no”. Los usuarios copiaban sus archivos a una carpeta separada antes de ejecutar un agente. O evitaban darle al agente acceso de escritura en absoluto. O vigilaban cada operación de archivo en tiempo real, lo que derrotaba el propósito de la ejecución autónoma.

El versionado elimina esa ecuación. El riesgo de que un agente estropee archivos es cero, porque cualquier cambio se puede revertir al instante. Los usuarios no necesitan copiar archivos antes de ejecutar tareas. No necesitan observar al agente trabajar. Simplemente lo dejan ejecutar, revisan los resultados más tarde y revierten cualquier cosa que no esté bien.

Esto cambia la relación de “delegación cuidadosa” a “delegación confiada”. Ejecuta la tarea. Verifica los resultados. Mantén lo que es bueno. Revierte lo que no. Toma diez segundos en lugar de diez minutos de preparación previa a la tarea.

La lección más amplia

Los agentes de IA son poderosos. También son imperfectos. La solución no es hacerlos perfectos —ese es un estándar imposible. La solución es hacer que sus imperfecciones sean reversibles.

El versionado de archivos es un ejemplo de un principio más amplio: construir redes de seguridad, no barandillas. Las barandillas impiden que la IA actúe. Las redes de seguridad permiten que la IA actúe libremente mientras aseguran que los errores se puedan corregir.

La ejecución en sandbox es una red de seguridad (contiene daños). El versionado de archivos es una red de seguridad (preserva el estado anterior). El registro de eventos es una red de seguridad (crea auditorías). Cada uno permite que la IA sea más autónoma al hacer que la autonomía sea menos arriesgada.

Los agentes de IA en LikeClaw están mejorando cada semana. Pero nunca serán perfectos. Y eso está bien, porque con el versionado, no tienen que serlo.