Herramienta de línea de comandos diseñada para "condensar" la estructura y el código de un proyecto de programación en un único archivo Markdown (.md).
Especialmente útil para generar contexto limpio y estructurado para alimentar a LLMs (como ChatGPT, Claude, o Llama) al hacer consultas sobre tu código base.
- Exclusivo por defecto: Ignora automáticamente carpetas ocultas (
.git,.vscode,.env) para evitar ruido innecesario. - Soporte
.gitignore: Interpreta tu gitignore nativo para omitir archivos irrelevantes. - Perfiles Integrados (Presets): Configuraciones predefinidas para
python,web,arduinoystm32que filtran automáticamente basura (__pycache__,node_modules, binarios, etc.). - Árbol de Directorios: Genera una representación visual de la arquitectura de tu proyecto al inicio del documento.
- Modo "Solo Cabeceras": Ideal para C/C++, permite extraer solo los archivos de interfaz (
.h,.hpp) de ciertas carpetas para reducir el tamaño del prompt.
- Python 3.6 o superior.
- Librería externa
pathspec(el instalador intentará instalarla por ti).
Para poder usar el comando ctxpack desde cualquier terminal, descarga o clona este repositorio y ejecuta el instalador correspondiente a tu sistema operativo.
- Haz doble clic en el archivo
install.bat. - Cierra la terminal y reinicie la computadora.
- Abre una terminal en la carpeta del repositorio.
- Ejecuta:
chmod +x install.sh ./install.sh
El formato básico del comando es:
ctxpack <ruta_del_proyecto> <archivo_salida.md>Para condensar el proyecto en la carpeta actual y guardarlo en contexto.md:
ctxpack . contexto.mdAnalizar un proyecto de Python, generar el árbol visual, incluir metadatos (líneas/tamaño) y respetar el .gitignore:
ctxpack ./mi_backend backend_resumen.md -p python -t -m -g-p, --profile <nombre>: Aplica un filtro predefinido (python,web,arduino,stm32).-t, --add-tree: Dibuja el árbol de carpetas al inicio del Markdown.-g, --use-gitignore: Aplica las reglas de exclusión del.gitignoredel proyecto.-m, --include-metadata: Añade el peso y número de líneas arriba de cada bloque de código.-H, --add-hidden: Fuerza la inclusión de archivos y carpetas ocultas (que empiezan por.).-xd, --exclude-dirs <dir1> <dir2>: Excluye carpetas manualmente.-xf, --exclude-files <file1>: Excluye archivos específicos.-xe, --exclude-extensions <ext1>: Excluye extensiones (ej.-xe .csv .json).
Para ver todas las opciones disponibles, ejecuta: ctxpack --help