English · Español English · Español

Powered by graphify Desarrollado con graphify

The knowledge graph engine that turns folders of notes, code, papers, and media into a queryable graph your AI tools can traverse. El motor de grafos de conocimiento que convierte carpetas de notas, código, artículos y multimedia en un grafo consultable que tus herramientas de IA pueden recorrer.

Install · Quick Start · Multiple Brains · Commands · Template Ownership · Inside AI Tools · New Machine Setup · Options · Credits Instalación · Inicio rápido · Múltiples cerebros · Comandos · Propiedad de plantillas · Dentro de las herramientas de IA · Configuración en una máquina nueva · Opciones · Créditos

Install

Instalación

To install the tool globally: Para instalar la herramienta de forma global:

npm install -g @jorge-moreira.dev/ai-brain-tool

Then use anywhere: Después úsala desde cualquier lugar:

ai-brain <command>

[!NOTE] You can also opt to use the tool portable using: También puedes usar la herramienta de forma portable con:

npx @jorge-moreira.dev/ai-brain-tool <command>

Quick start

Inicio rápido

Run the interactive wizard: creates your brain folder, installs graphify, configures every detected AI tool (Claude Code, OpenCode, Cursor, Gemini CLI, GitHub Copilot CLI, OpenAI Codex CLI), and optionally sets up Obsidian. Ejecuta el asistente interactivo: crea la carpeta de tu cerebro, instala graphify, configura todas las herramientas de IA detectadas (Claude Code, OpenCode, Cursor, Gemini CLI, GitHub Copilot CLI, OpenAI Codex CLI) y opcionalmente configura Obsidian.

npx @jorge-moreira.dev/ai-brain-tool setup
ai-brain setup

Multiple brains

Múltiples cerebros

The tool supports multiple brains. Brains configurations are stored in ~/.ai-brain-tool/config.json. La herramienta soporta múltiples cerebros. Las configuraciones de cada cerebro se guardan en ~/.ai-brain-tool/config.json.

Brain identifier

Identificador del cerebro

Every brain has a short identifier (e.g., work, personal) that identifies it. Use --brain-id <id> to target a specific brain: Cada cerebro tiene un identificador corto (por ejemplo, work, personal) que lo distingue. Usa --brain-id <id> para apuntar a un cerebro específico:

ai-brain <command> personal
ai-brain <command> --brain-id personal

[!NOTE] If you're in a brain folder (or a subfolder), commands automatically detect which brain to use — no need to specify the identifier. Si estás dentro de la carpeta de un cerebro (o de una subcarpeta), los comandos detectan automáticamente cuál usar — no hace falta indicar el identificador.

List brains

Listar cerebros

ai-brain list

Shows all registered brains with their identifiers and paths. Muestra todos los cerebros registrados con sus identificadores y rutas.

Commands

Comandos

ai-brain setup

Run the interactive setup wizard. Ejecuta el asistente interactivo de configuración.

• Fresh machine: full wizard — creates the brain folder, initialises git, installs graphify, configures AI tools, sets up Obsidian, prompts for brain identifier (defaults to folder name).
• Inside an existing brain folder (e.g. after git clone): new-machine mode — only recreates .venv, patches local AI tool configs, prompts for brain identifier (defaults to folder name).
• Máquina nueva: asistente completo — crea la carpeta del cerebro, inicializa git, instala graphify, configura las herramientas de IA, prepara Obsidian y pregunta por el identificador del cerebro (por defecto el nombre de la carpeta).
• Dentro de una carpeta de cerebro existente (por ejemplo, tras un git clone): modo «máquina nueva» — solo recrea .venv, parchea las configuraciones locales de las herramientas de IA y pregunta por el identificador del cerebro (por defecto el nombre de la carpeta).

What the wizard configures per selected AI tool: Lo que el asistente configura para cada herramienta de IA seleccionada:

• MCP server entry pointing to the brain's graph.json
• /brain skill installed globally in the tool
• Always-on context file written into the brain folder (CLAUDE.md, AGENTS.md, GEMINI.md, .cursor/rules/ai-brain.mdc, or .github/copilot-instructions.md)
• Entrada de servidor MCP apuntando al graph.json del cerebro
• Skill /brain instalado de forma global en la herramienta
• Archivo de contexto «always-on» escrito en la carpeta del cerebro (CLAUDE.md, AGENTS.md, GEMINI.md, .cursor/rules/ai-brain.mdc o .github/copilot-instructions.md)

Git options asked during setup: Opciones de Git que se preguntan durante la configuración:

• Git repository or local folder only
• Optional remote URL
• Whether to commit the extraction cache (saves tokens on new machines)
• Auto-sync — whether /brain update should commit and push automatically after each graph rebuild
• Repositorio Git o solo carpeta local
• URL remota opcional
• Si se debe versionar la caché de extracción (ahorra tokens en máquinas nuevas)
• Auto-sync — si /brain update debe hacer commit y push automáticamente tras cada reconstrucción del grafo

ai-brain setup

ai-brain update

Rebuild the knowledge graph from raw/ using graphify. If auto-sync was enabled during setup, commits and pushes after the rebuild. Reconstruye el grafo de conocimiento desde raw/ usando graphify. Si se activó el auto-sync durante la configuración, hace commit y push tras la reconstrucción.

ai-brain update                   # Used if already on the brain folder
ai-brain update --brain-id work   # Specify brain by identifier

[!NOTE] Inside any AI tool, /brain update loads the graphify skill which rebuilds the graph using AI subagents for semantic extraction. If auto-sync was enabled during setup, the skill automatically commits and pushes after the rebuild. Dentro de cualquier herramienta de IA, /brain update carga el skill de graphify, que reconstruye el grafo usando subagentes de IA para la extracción semántica. Si el auto-sync estaba activado, el skill hace commit y push automáticamente tras la reconstrucción.

ai-brain status

Show brain health: tool version, graphify version, graph node/edge count, brain path. Muestra la salud del cerebro: versión de la herramienta, versión de graphify, número de nodos/aristas del grafo y ruta del cerebro.

ai-brain status         # Used if already on the brain folder
ai-brain status work    # Specify brain by identifier

Equivalent inside any AI tool: status Equivalente dentro de cualquier herramienta de IA: status

ai-brain templates list

List all templates — both tool-managed (_bundled/) and yours (_custom/). Lista todas las plantillas — tanto las gestionadas por la herramienta (_bundled/) como las tuyas (_custom/).

ai-brain templates list
ai-brain templates list work    # Specify brain by identifier

ai-brain templates add

Create a new custom template from a minimal starter file. Places the file in raw/templates/markdown/_custom/ or raw/templates/web-clipper/_custom/. Files in _custom/ are never touched by upgrades. Crea una nueva plantilla personalizada a partir de un archivo de inicio mínimo. La coloca en raw/templates/markdown/_custom/ o raw/templates/web-clipper/_custom/. Los archivos en _custom/ nunca se ven afectados por las actualizaciones.

ai-brain templates add
ai-brain templates add work    # Specify brain by identifier

ai-brain upgrade

Upgrade graphify in .venv/ and refresh all bundled templates in _bundled/. Your custom templates in _custom/ are never touched. Actualiza graphify en .venv/ y refresca todas las plantillas integradas en _bundled/. Tus plantillas personalizadas en _custom/ nunca se modifican.

ai-brain upgrade        # Used if already on the brain folder
ai-brain upgrade work   # Specify brain by identifier

ai-brain list

List all registered brains with their identifiers and paths. Lista todos los cerebros registrados con sus identificadores y rutas.

ai-brain list

ai-brain setup-obsidian

Setup or update Obsidian vault configuration for a brain. Configura o actualiza la configuración del vault de Obsidian para un cerebro.

ai-brain setup-obsidian
ai-brain setup-obsidian --update

Template ownership

Propiedad de plantillas

raw/templates/
├── markdown/
│   ├── _bundled/    ← tool-owned, rewritten on upgrade
│   └── _custom/     ← yours, never touched by the tool
└── web-clipper/
    ├── _bundled/    ← tool-owned, rewritten on upgrade
    └── _custom/     ← yours, never touched by the tool

Inside AI tools

Dentro de las herramientas de IA

After setup, a /brain skill is installed in each configured AI tool. Commands run from inside the brain folder manage the brain; query commands work from any project. Tras la configuración, se instala un skill /brain en cada herramienta de IA configurada. Los comandos lanzados desde dentro de la carpeta del cerebro gestionan ese cerebro; los comandos de consulta funcionan desde cualquier proyecto.

/brain update              — rebuild graph from raw/ (+ auto-sync if enabled)
/brain add <url>           — fetch a URL and add it to raw/
/brain templates           — list available templates
/brain wiki                — generate agent-crawlable wiki (graphify-out/wiki/)
/brain obsidian            — generate Obsidian vault export
/brain query "<question>"  — query the knowledge graph via MCP
/brain path "<A>" "<B>"    — find shortest path between two concepts via MCP
/brain status              — show graph stats and tool version

New machine setup

Configuración en una máquina nueva

After cloning your brain repo on a new machine: Tras clonar el repositorio de tu cerebro en una máquina nueva:

cd your-brain
ai-brain setup

The tool detects the existing brain, skips scaffolding, and only recreates .venv and patches your local AI tool configs. La herramienta detecta el cerebro existente, omite el scaffolding y solo recrea .venv y parchea las configuraciones locales de tus herramientas de IA.

Options

Opciones

--help, -h      Show help for any command
--version, -v   Show the current tool version

Contributing

Cómo contribuir

See CONTRIBUTING.md for setup instructions, testing, and contribution guidelines. Consulta CONTRIBUTING.md para las instrucciones de configuración, pruebas y pautas de contribución.

Credits

Créditos

ai-brain-tool is a facade over graphify by @safishamsi. All graph extraction, clustering, wiki generation, Obsidian export, and MCP serving is done by graphify. This tool adds the setup wizard, platform integrations, and /brain skill layer on top. ai-brain-tool es una fachada sobre graphify de @safishamsi. Toda la extracción del grafo, el clustering, la generación de wikis, la exportación a Obsidian y el servidor MCP los hace graphify. Esta herramienta añade encima el asistente de configuración, las integraciones con cada plataforma y la capa de skill /brain.