treelis

treelis es una utilidad CLI que renderiza la estructura de carpetas y archivos de cualquier proyecto como un flujo interactivo tipo n8n directamente en tu navegador. Basta con ejecutar el comando y explorar mediante zoom y paneo para entender la arquitectura de un repositorio al instante.

Características principales

• ✅ Ejecución directa con npx treelis sin instalación previa
• ✅ Servidor Express automático en http://localhost:8888
• ✅ Visualización jerárquica estilo flujo con Cytoscape.js
• ✅ Zoom con rueda del ratón y paneo mediante arrastre
• ✅ Selección de nodos para ver metadatos (ruta, extensión, tamaño)
• ✅ Cambio instantáneo entre tema claro y oscuro
• ✅ Nodos con tamaño adaptativo según la longitud del nombre
• ✅ Exclusión por defecto de carpetas ruidosas (node_modules, .git, dist, etc.)
• ✅ Interfaz moderna y responsive que abre el navegador automáticamente

Instalación

Uso global (recomendado para emplear npx)

npm install -g treelis

Uso con npx

cd /ruta/a/tu/proyecto
npx treelis

Desarrollo local

git clone <repo>
cd treelis
npm install
npm start

El servidor arrancará en http://localhost:8888 y abrirá tu navegador predeterminado.

Controles de la vista

• 🔍 Zoom In / Zoom Out: Botones o rueda del ratón
• ⊡ Fit: Ajusta el grafo al ancho disponible
• ↻ Reset: Recarga la estructura desde el directorio analizado
• Click en un nodo: Muestra información detallada en el panel lateral
• Click + arrastrar: Paneo por el grafo

Personalización rápida

• Colores de nodos: Ajusta la función getStyles() en public/main.js
• Carpetas excluidas: Edita la expresión regular exclude en server.mjs
• Puerto del servidor: Cambia process.env.PORT || 8888 en server.mjs

Limitaciones

• Grafo muy grandes (100k+ nodos) pueden impactar el rendimiento del navegador
• Solo lectura: la aplicación no permite editar archivos
• Requiere un navegador moderno (Chrome, Firefox, Safari, Edge)

Licencia

MIT