treedocs es una herramienta de línea de comandos escrita en Swift que genera y mantiene un mapa legible y versionado de la estructura de un repositorio de software. Su objetivo es ofrecer a compañeros recién incorporados, a futuros desarrolladores y a agentes de codificación un contexto conciso sobre proyectos complejos, evitando que tengan que explorar el código de forma desordenada.
El funcionamiento se basa en un archivo llamado treedocs.yaml, que refleja el árbol de carpetas del proyecto y asocia a cada archivo y directorio una descripción breve en YAML. Ese mismo archivo se valida frente a un esquema JSON canónico, de modo que editores, sistemas de integración continua y agentes de inteligencia artificial pueden interpretarlo de forma consistente. La documentación puede comprobarse con treedocs check, actualizarse con treedocs sync, y opcionalmente vincularse a un hook de pre-commit para impedir que se incorporen cambios sin documentar.
Entre los comandos disponibles se encuentran treedocs init, que crea el YAML inicial; treedocs show, que muestra el árbol documentado resaltando en verde las entradas vigentes y en rojo las obsoletas; treedocs explore, pensado para la exploración progresiva del código; y treedocs check, que valida la coherencia del archivo. La versión 0.2.0 se distribuye solo en formato código fuente y requiere un entorno con Swift 6, normalmente Xcode 16 o superior, siendo compatible con macOS 13 y posteriores. Puede instalarse a través de Homebrew, Mint o mise, si bien la integración de mise con Swift Package Manager es experimental y necesita activarse con MISE_EXPERIMENTAL=true.