# Instrucciones para el agente: codedb: da a tu agente un mapa consultable del código

Pega este texto a tu agente (Claude Code, Codex, OpenCode, Hermes o el que uses) y dile «ayúdame a montarlo». Son los pasos para ponerlo en marcha; el porqué de cada pieza está en la guía completa.

- Dificultad: intermedio
- Proyecto: https://github.com/justrach/codedb (licencia BSD-3-Clause)
- Guía completa: https://lab.wisd.ai/hub/codedb-code-intelligence

---

## Para el agente: cómo acompañar al usuario

1. Pregunta primero para qué lo quiere. Si su objetivo no necesita algún paso, sáltalo.
2. Antes de instalar, comprueba lo que ya tiene (versiones, claves, sistema operativo).
3. Avanza un paso cada vez: explica en una frase qué vas a hacer y deja que el usuario lo ejecute o lo apruebe.
4. Tras cada paso, comprueba que funcionó antes de seguir. Si falla, para y explica el error.
5. No inventes comandos ni opciones: si la documentación del proyecto contradice estos pasos, manda la documentación.
6. Al terminar, haz una prueba real con el objetivo del usuario y dile dónde profundizar.

---

## Pasos de configuración

Comprueba que tienes Node.js ≥18 y npm/npx disponibles, según el [manifiesto publicado de codedeebee](https://www.npmjs.com/package/codedeebee). En macOS o Linux puedes iniciar el servidor con la vía npm del README:

```sh
npx -y codedeebee mcp
```

Ese comando mantiene el servidor stdio esperando al cliente; no es una sesión interactiva que termine por sí sola. Detén la prueba con Ctrl+C y registra el mismo comando en el cliente. Por ejemplo, en Claude Code, adapta el registro de [docs/mcp.md](https://github.com/justrach/codedb/blob/HEAD/docs/mcp.md) a la vía npm:

```sh
claude mcp add codedb -s user -- npx -y codedeebee mcp
claude mcp list
```

El paquete npm se llama `codedeebee` y descarga el binario nativo; no se presupone un ejecutable global `codedb`. Abre Claude Code desde la raíz del proyecto objetivo y comprueba la conexión antes de pedir buscar una definición. Para Windows usa su ruta PowerShell documentada.

## Comprobación

Consulta una definición que conozcas y compara la ruta y el código. Comprueba que el agente utiliza la carpeta de proyecto correcta.

## Si algo falla

Si el símbolo no aparece, revisa lenguaje y alcance del índice. Si el cliente no conecta, comprueba el registro MCP y los mensajes de arranque.

Consulta [el README oficial](https://github.com/justrach/codedb#readme) para requisitos y variantes de instalación.