Ponytrail es una herramienta de línea de comandos y un conjunto de skills para agentes de IA que permite registrar por qué se modificaron los archivos, visualizar esos cambios como un árbol de historial local y revertirlos a un estado anterior. Su objetivo es ofrecer una trazabilidad ligera, similar a un mini sistema de control de versiones, pensada para sesiones de trabajo con asistentes de código.
Funcionamiento. Ponytrail almacena su información en la carpeta .pony-trail/ dentro del proyecto, un directorio que debe mantenerse fuera de Git al ser estado de ejecución local. Cada vez que se ejecuta una acción relevante (por ejemplo, instalar un skill de agente), la herramienta crea una snapshot con identificador temporal único, que incluye los estados previo y posterior de los archivos afectados.
Casos de uso. La CLI está orientada a desarrolladores que usan agentes de IA como Claude, Copilot o Codex y necesitan auditar qué modificaciones introdujo el agente en su árbol de archivos. Los comandos principales son ponytrail history (con o sin flag --details para ver acción, resumen, comprobaciones, resultado y rollback) y ponytrail revert <snapshot-id>, que admite --dry-run para previsualizar los cambios. En entornos no interactivos, Ponytrail imprime el plan y cancela la operación sin modificar el proyecto, evitando mutaciones accidentales. El historial se almacena en formato JSONL y en archivos Markdown por sesión, lo que facilita su inspección y procesamiento automatizado.
Instalación y desarrollo. La distribución se realiza vía npx ponytrail o bunx ponytrail, y el repositorio utiliza Bun para la construcción, las pruebas y la comprobación de tipos con bun install, bun run build, bun test y bun run check.