humAIn Studio

Your persistent code graph for humans and AI agents. Understand your codebase faster, share context with AI agents, and build without repeatedly explaining your architecture.

Tu grafo de código persistente para humanos y agentes de IA. Comprende tu código fuente más rápido, comparte contexto con agentes de IA y desarrolla sin tener que explicar tu arquitectura una y otra vez.

Created by CucaRasta19

AI-native code intelligence powered by persistent code graphs.

Turn any repository into a persistent, interactive visual graph of your code—including classes, functions, methods, and the calls or relationships between them. It is designed to help you quickly understand a project's architecture and enable AI agents (such as Claude Code, Codex, Aider, etc.) to query the code structure without having to read through files one by one.

Convierte cualquier repositorio,proyecto en un grafo visual persistente e interactivo de tu código: clases, funciones, métodos y las llamadas/relaciones entre ellos. Pensado para entender rápido la arquitectura de un proyecto y para que agentes de IA (Claude Code, Codex, Aider, etc.) puedan consultar la estructura del código sin tener que leer archivo por archivo.

Demo

Screenshots

Interactive Code Graph

CLI Analysis

AI Agent Integration

Supported languages

| Language | Extensions | What it analyzes | |---|---|---| | JavaScript | .js .jsx .mjs .cjs | Classes, functions, function calls | | TypeScript | .ts .tsx | Classes, functions, function calls | | Python | .py | Classes, functions, function calls | | C# | .cs | Namespaces, classes, methods (incl. constructors), calls, instantiation (new), use of external types | | Go | .go | Structs (as "classes"), functions and methods with receivers, calls | | Rust | .rs | Structs, enums, traits (as "classes"), functions, calls | | Java | .java | Classes, interfaces, enums, methods, constructors, calls | | PHP | .php | Classes, interfaces, functions, methods, calls | | Kotlin | .kt .kts | Classes, functions, calls | | Ruby | .rb | Classes, methods, calls | | C | .c .h | Structs (as "classes"), functions, calls | | C++ | .cpp .cc .cxx .hpp .hh | Classes, structs, functions, calls |

In languages ​​without the concept of a "class" (Go, Rust, C), the tool maps to the closest data structure (struct, enum, trait) to maintain the same visual grouping representation.

Lenguajes soportados

| Lenguaje | Extensiones | Qué analiza | |---|---|---| | JavaScript | .js .jsx .mjs .cjs | Clases, funciones, llamadas entre funciones | | TypeScript | .ts .tsx | Clases, funciones, llamadas entre funciones | | Python | .py | Clases, funciones, llamadas entre funciones | | C# | .cs | Namespaces, clases, métodos (incl. constructores), llamadas, instanciación (new), uso de tipos externos | | Go | .go | Structs (como "clases"), funciones y métodos con receiver, llamadas | | Rust | .rs | Structs, enums, traits (como "clases"), funciones, llamadas | | Java | .java | Clases, interfaces, enums, métodos, constructores, llamadas | | PHP | .php | Clases, interfaces, funciones, métodos, llamadas | | Kotlin | .kt .kts | Clases, funciones, llamadas | | Ruby | .rb | Clases, métodos, llamadas | | C | .c .h | Structs (como "clases"), funciones, llamadas | | C++ | .cpp .cc .cxx .hpp .hh | Clases, structs, funciones, llamadas |

En lenguajes sin el concepto de "clase" (Go, Rust, C), la herramienta mapea la estructura de datos más cercana (struct, enum, trait) para mantener la misma representación visual de agrupación.

Installation

Install humAIn Studio globally from npm:

npm install -g humain-studio

Verify Installation

humainstudio --help

Development

Clone the repository:

git clone https://github.com/cucarasta19/humAIn-Studio.git
cd humAIn-Studio
npm install
npm link

Instalación

Instala Humain Studio de forma global desde npm:

npm install -g humain-studio

Verificar la instalación

humainstudio --help

Modo Desarrolladores

Clona el repositorio:

git clone https://github.com/cucarasta19/humAIn-Studio.git
cd humAIn-Studio
npm install
npm link

Requirements

• Node.js >= 16

*If you don't have it installed on your PC, you can install it using the following command:

winget install OpenJS.NodeJS

*If it is already installed and you want to update it:

winget upgrade OpenJS.NodeJS

*Verify:

node -v

npm -v

Usage

Scan a project and open the viewer

humainstudio scan --path "/path/to/your/project"

This analyzes the code, generates the graph in .humai/graph.json within that folder, and opens the interactive viewer at http://localhost:4477. Any graph positions you adjust are automatically saved in .humai/—they are not lost even if you close the server.

To reopen the viewer later (or if you closed it), simply run the same command again:

humainstudio scan --path "/path/to/your/project"

Requisitos

• Node.js >= 16

*Si no lo tienes instalado en tu PC, puedes instalarlo usando el siguiente comando:

winget install OpenJS.NodeJS

*Si ya está instalado y quieres actualizarlo:

winget upgrade OpenJS.NodeJS

*Verificación:

node -v

npm -v

Uso

Escanear un proyecto y abrir el visor

humainstudio scan --path "/ruta/a/tu/proyecto"

Esto analiza el código, genera el grafo en .humai/graph.json dentro de esa carpeta, y abre el visor interactivo en http://localhost:4477. Las posiciones que muevas en el grafo quedan guardadas automáticamente en .humai/ — no se pierden aunque cierres el servidor.

Para volver a abrir el visor más adelante (o si lo cerraste), simplemente corre el mismo comando otra vez:

humainstudio scan --path "/ruta/a/tu/proyecto"

Options:

• --port <n> — changes the viewer port (useful if you already have another scan running). Defaults to 4477.
• --headless — updates only .humai/graph.json, without opening the viewer. Ideal for scripts or automated AI agents.

Opciones:

• --port <n> — cambia el puerto del visor (útil si ya tienes otro scan corriendo). Por defecto 4477.
• --headless — solo actualiza .humai/graph.json, sin abrir el visor. Ideal para scripts o agentes de IA automatizados.

Graph queries (in a new terminal, while the viewer is still running)

# Most connected nodes (architectural hubs)
humainstudio god-nodes --path "/path/to/your/project" --top 10

# Plain-language explanation of a node and its neighbors
humainstudio explain "ClassName" --path "/path/to/your/project"

# Shortest path between two nodes
humainstudio path "NodeA" "NodeB" --path "/path/to/your/project"

# Which nodes depend on X (impact analysis)
humainstudio affected "FunctionName" --path "/path/to/your/project"

# Natural language query (BFS traversal of the graph)
humainstudio query "what does class X do" --path "/path/to/your/project"

Consultas sobre el grafo (en una terminal nueva, mientras el visor sigue corriendo)

# Nodos más conectados (hubs arquitectónicos)
humainstudio god-nodes --path "/ruta/a/tu/proyecto" --top 10

# Explicación en lenguaje llano de un nodo y sus vecinos
humainstudio explain "NombreDeClase" --path "/ruta/a/tu/proyecto"

# Camino más corto entre dos nodos
humainstudio path "NodoA" "NodoB" --path "/ruta/a/tu/proyecto"

# Qué nodos dependen de X (análisis de impacto)
humainstudio affected "NombreDeFuncion" --path "/ruta/a/tu/proyecto"

# Pregunta en lenguaje natural (recorrido BFS sobre el grafo)
humainstudio query "que hace la clase X" --path "/ruta/a/tu/proyecto"

AI Agent Integration

Give your AI coding agents persistent knowledge of your codebase. Install humAIn Studio instructions into your agent context:

#ClaudeCode
humainstudio claude install
humainstudio claude uninstall

# Codex, OpenCode, Aider, Droid, Trae, etc. (they use AGENTS.md)
humainstudio agents install
humainstudio agents uninstall

Integración de agentes de IA

Proporciona a tus agentes de IA de programación un conocimiento persistente de tu base de código. Incorpora las instrucciones de humAIn Studio al contexto de tu agente:

# Claude Code
humainstudio claude install
humainstudio claude uninstall

# Codex, OpenCode, Aider, Droid, Trae, etc. (usan AGENTS.md)
humainstudio agents install
humainstudio agents uninstall

Note on npm audit

During installation, you may see a vulnerability notice (npm audit). These are standard warnings regarding transitive dependencies—common in local CLI tools—and do not indicate malicious code or affect the tool's functionality. Do not run npm audit fix --force: it may update packages to versions incompatible with the code parser (Tree-sitter) and break the scanning process.

Nota sobre npm audit

Al instalar puede que veas un aviso de vulnerabilidades (npm audit). Son advertencias estándar de dependencias transitivas típicas en herramientas CLI de uso local — no indican código malicioso ni afectan el funcionamiento de la herramienta. No ejecutes npm audit fix --force: puede actualizar paquetes a versiones incompatibles con el analizador de código (Tree-sitter) y romper el escaneo.

License

MIT

Licencia

MIT