Code Snapshot
Una herramienta CLI en Python para crear snapshots completos y autocontenidos de tu base de código. El contexto perfecto para LLMs, documentación y archivado.
Code Snapshot
El Desafío: El Contexto lo es Todo
En la era de la IA, interactuar con Grandes Modelos de Lenguaje (LLMs) sobre una base de código compleja es un desafío fundamental. La "ventana de contexto" —la memoria a corto plazo de la IA— es limitada. Proporcionarle archivos uno por uno es ineficiente y hace que el modelo pierda la visión global del proyecto. ¿Cómo podemos tener una conversación inteligente sobre una función si la IA no conoce las clases que la invocan o las utilidades de las que depende?
Code Snapshot nació de esta necesidad práctica: la de crear una herramienta interna en Fractalcode para consolidar un proyecto entero en un formato que cualquier IA pudiera entender de una sola vez.
La Solución: Un Snapshot Coherente y Estructurado
Code Snapshot resuelve este problema de raíz. Es una herramienta de línea de comandos que recorre un proyecto, filtra el ruido (como node_modules o archivos de imagen) y empaqueta todo el código relevante en un único archivo de texto.
El resultado no es un simple volcado de texto. Cada archivo en el snapshot está claramente delimitado e incluye metadatos cruciales del último commit de Git, proporcionando una trazabilidad invaluable. Es una herramienta creada por desarrolladores, para desarrolladores, siguiendo la filosofía de Fractalcode de construir soluciones robustas y bien diseñadas para problemas reales.
Características Clave
Snapshot Unificado
Genera un solo archivo .txt con todo el contenido relevante del proyecto.
Metadatos de Git
Incluye información del último commit (hash, autor y fecha) para cada archivo.
Altamente Configurable
Un simple archivo config.json permite definir con precisión qué excluir.
Formato Limpio
La salida es estructurada y legible tanto por humanos como por máquinas.
Interfaz Profesional
Muestra una barra de progreso y salida colorida para una gran experiencia de usuario.
Modo de Prueba Rápida
Un flag --limit para procesar solo unos pocos archivos, agilizando las pruebas.
Construido Con
Python
Git
- CLI
- Open Source
- Developer Tool
- GitPython
- Colorama
- Argparse
Pruébalo Tú Mismo
Code Snapshot es un proyecto de código abierto bajo licencia MIT. Te invitamos a explorar el código, usarlo en tus propios proyectos y contribuir si lo deseas. La documentación completa se encuentra en el README del repositorio.
