deepwiki-rs genera documentación de arquitectura desde tu código: utiliza IA para convertir los archivos de un proyecto en explicaciones y diagramas C4.
El proyecto se presenta como Litho, aunque el paquete y el comando conservan el nombre deepwiki-rs. Es una herramienta escrita en Rust, con licencia MIT, que aborda un problema habitual: entender cómo encajan las piezas de un repositorio cuando su documentación está incompleta.
Si acabas de incorporarte a un proyecto o estás preparando un traspaso, el resultado puede servir como punto de partida para revisar, corregir y compartir. Repositorio oficial
¿Qué documentación genera deepwiki-rs?
Litho produce documentación de arquitectura sobre el sistema, sus módulos, flujos de trabajo e interfaces, con diagramas expresados en Mermaid.
Su proceso recorre el proyecto, analiza el código con ayuda de modelos de lenguaje y organiza los resultados en documentos. También puede incorporar material existente, como decisiones de arquitectura y esquemas de bases de datos, para añadir contexto que los archivos de código no explican por sí solos. Documentación del proyecto
Ese último punto importa. El código puede mostrar que un servicio utiliza una cola. Un registro de decisiones de arquitectura puede explicar por qué el equipo eligió el procesamiento asíncrono. Una descripción útil del sistema necesita ambas cosas.
¿Qué es el modelo C4 y para qué sirve?
El modelo C4 organiza la arquitectura en niveles sucesivos de detalle: contexto del sistema, contenedores, componentes y código.
La vista de contexto sitúa el sistema entre sus usuarios y dependencias externas. La de contenedores identifica aplicaciones y almacenes de datos; aquí, «contenedor» no significa necesariamente Docker. Las vistas de componentes y código permiten examinar partes más pequeñas del diseño.
No necesitas los cuatro niveles en todos los proyectos. La guía oficial de C4 permite utilizar los niveles que aporten valor. Guía de diagramas C4
En una primera revisión de la documentación generada, empieza por los límites del sistema y sus aplicaciones principales. Si eso está mal, los diagramas más detallados solo desarrollarán el error.
¿Cómo instalar deepwiki-rs?
La vía de instalación documentada utiliza Cargo:
cargo install deepwiki-rs
Hay una discrepancia en los requisitos que conviene detectar antes de empezar. Al 14 de septiembre de 2026, el README indica Rust 1.70 o posterior, pero el manifiesto actual del proyecto utiliza Rust edition 2024, introducida con Rust 1.85. Las dependencias podrían exigir un compilador todavía más reciente. Por tanto, el mínimo indicado en el README no basta para compilar el código actual. Manifiesto del proyecto, guía de ediciones de Rust
Los comandos de esta guía se contrastaron con la documentación y el código del repositorio; no hemos completado una instalación ni una ejecución de generación para esta nota.
¿Qué necesitas para generar documentación con deepwiki-rs?
Necesitas un repositorio que analizar y un proveedor de modelos de lenguaje preparado para utilizarlo con Litho.
El proyecto incluye un archivo de configuración de ejemplo pensado para copiarse como litho.toml. Contiene la selección del proveedor, la URL base de la API, la autenticación y elecciones de modelos separadas para el análisis habitual y el razonamiento más exigente.
Selecciona modelos que tu proveedor tenga disponibles actualmente, en lugar de copiar sin cambios los identificadores antiguos del ejemplo.
Ejecutar la CLI en tu ordenador no significa que la inferencia se quede allí. La configuración admite proveedores remotos y Ollama. El proveedor elegido determina adónde se envían las solicitudes al modelo; utilizar una API externa puede generar cargos. Implementación de la configuración
Empieza con un repositorio pequeño que tengas autorización para procesar con ese proveedor. Así podrás evaluar mejor la primera ejecución y observar el consumo antes de ampliar el alcance.
¿Cómo usar deepwiki-rs para documentar un repositorio?
Una vez preparado el proveedor, indica a Litho qué proyecto debe analizar y elige un directorio de salida:
deepwiki-rs --target-language en -p ./my-project -o ./docs
Sustituye ./my-project por la ruta del repositorio que quieres analizar. El comando selecciona explícitamente inglés y dirige la salida a ./docs; estas opciones están presentes en la implementación de la CLI. Código de la CLI
Para quienes trabajan en español hay una limitación: al 14 de septiembre de 2026, el español no figura en la lista documentada de idiomas de salida. Este recorrido utiliza la opción documentada de inglés.
Elige un directorio de salida separado para la prueba, de modo que puedas revisar el material generado antes de incorporarlo a la documentación que mantienes.
¿Cómo revisar la documentación de arquitectura generada por IA?
Comprueba si los documentos describen el sistema que realmente utilizas.
Elige un flujo que conozcas bien —autenticación, envío de un pedido o una tarea en segundo plano— y recórrelo siguiendo la explicación generada. Contrasta los componentes, las dependencias y los límites que menciona con el código fuente.
Después, busca tres tipos de errores:
- Intención inventada: una explicación plausible de una decisión de diseño que nadie documentó.
- Contexto ausente: infraestructura, servicios externos o comportamiento operativo que no aparecen en el repositorio analizado.
- Diagramas engañosos: relaciones convincentes a primera vista que apuntan en la dirección equivocada o atraviesan un límite incorrecto.
Estos son criterios de revisión, no defectos medidos en una prueba de Litho. Es lo que comprobaría para decidir si el resultado es lo bastante útil como para mantenerlo.
Las promesas de precisión y ahorro de tiempo deben presentarse como afirmaciones del proyecto hasta que las hayas evaluado con tu propio código.
¿Cómo actualizar la documentación cuando cambia el código?
Asigna un lugar explícito a la regeneración y la revisión dentro de tu flujo de trabajo.
La versión 1.6.0 publicada incluye controles para omitir etapas del proceso y forzar la regeneración. Su existencia no demuestra que un documento generado siga de forma continua todos los cambios posteriores. Notas de la versión
Registra qué commit describe cada ejecución. Cuando cambie la arquitectura, regenera el material correspondiente y revisa las diferencias junto con el código.
Al 14 de septiembre de 2026, el proyecto distingue la generación de documentos de Litho de Terrain, que presenta como un entorno más amplio para mantener conocimiento que los agentes puedan consultar. Esa distinción ayuda a decidir cuál de los dos proyectos evaluar. Presentación del proyecto
¿Cuándo merece la pena probar deepwiki-rs?
Merece la pena evaluarlo cuando necesitas un borrador estructurado de arquitectura para un repositorio que puedes verificar.
Nuestra guía de Repomix aborda cómo preparar el contexto de un repositorio para una IA. Litho se ocupa del siguiente trabajo editorial: organizar una interpretación del código en documentos.
Empieza con un proyecto y un flujo que conozcas. Si la explicación generada ayuda a otro desarrollador a encontrar los componentes adecuados y puedes corregir sus errores sin reescribirlo todo, tienes una base útil para un proceso de documentación.