Kodama IA: cómo convertir cualquier proyecto en un mapa que tu IA entiende
Qué es un grafo de conocimiento de código, por qué le ahorra tokens (y tiempo) a cualquier asistente de IA que trabaje en tu proyecto, y cómo funciona Kodama IA en la práctica.
Si trabajas con un asistente de IA (Claude Code, Cursor, GitHub Copilot u otro) en un proyecto de cierto tamaño, seguro ya viviste esto: cada nueva sesión, la IA tiene que releer código y documentación para entender qué existe y cómo está conectado — y eso cuesta tokens, tiempo, y a veces respuestas incompletas porque la IA nunca llegó a ver todo el proyecto. Kodama IA nació para resolver exactamente ese problema.
¿Qué hace Kodama IA?
Kodama IA analiza cualquier carpeta de proyecto — código, documentos, lo que sea — y genera un mapa de conocimiento: qué archivos existen, cómo se relacionan entre sí, y un reporte en lenguaje claro de la arquitectura general. Ese mapa se puede consultar como una página HTML interactiva (autocontenida, sin servidor), o entregarse directamente a un asistente de IA en formato JSON para que lo use como memoria persistente del proyecto entre sesiones.
Por qué esto le ahorra tokens a tu IA
La extracción del mapa usa análisis sintáctico (AST) local — no un modelo de lenguaje — así que generar el mapa no gasta ni un token, las veces que quieras. En una evaluación propia sobre dos proyectos reales (uno en Java, otro en Python), el reporte generado por Kodama redujo hasta un 90.6% los tokens que la IA necesitó frente a leer código y documentación completos, y hasta un 87.9% frente a leer solo el código. El resultado varía según el proyecto y la tarea — no todo se resuelve solo con el reporte — pero el ahorro es consistente.
¿Para quién es útil?
- Equipos de desarrollo — nuevos integrantes entienden dónde está cada cosa sin que alguien tenga que explicarlo oralmente.
- Freelancers y consultores — reciben un proyecto de cliente y entienden la estructura completa en minutos, no en días.
- Negocios con archivos dispersos — cualquiera en la empresa ve de un vistazo qué hay en cada carpeta, sin abrir un IDE.
- Usuarios de asistentes de IA en general — el mapa sirve como memoria de largo plazo del proyecto para Claude Code u otra herramienta similar.
Cómo funciona en la práctica
Se instala 100% offline (una vez descargado, no necesita internet ni llamadas a ningún servicio externo — solo tener Python 3.10 a 3.13 instalado). Funciona igual en Windows y Linux. El Explorador Interactivo que genera es un único archivo .html que se comparte por correo o USB y se abre con doble clic. Y todo lo que genera se puede exportar en PNG y PDF para presentaciones, o en JSON y CSV para pegarlo directo en el contexto de tu IA.
Preguntas frecuentes
¿Necesito internet para usar Kodama IA?
No, una vez instalado. La instalación offline incluye todas las dependencias; solo necesitas tener Python 3.10–3.13 ya instalado en tu equipo.
¿Gasta tokens de IA al generar el mapa?
No. La extracción usa análisis sintáctico (AST) local, no un modelo de lenguaje — mapear tu proyecto es gratis, las veces que quieras.
¿Cuánto cuesta y qué incluye?
Un pago único de $60, sin suscripción: todos los comandos, Explorador Interactivo con proyectos ilimitados, instalación 100% offline, exportación completa (PNG, PDF, JSON, CSV) y soporte por correo.
¿Sirve con Claude Code u otros asistentes de IA?
Sí — el mapa generado (graph.json, GRAPH_REPORT.md) está diseñado específicamente para que un asistente de IA lo use como memoria persistente del proyecto entre sesiones.