LaCoCo

LaCoCo es una herramienta de linea de comandos que prepara contexto de un proyecto TypeScript/JavaScript para asistentes de programacion. Indexa el proyecto localmente y permite recuperar fragmentos relevantes mediante CLI, HTML de inspeccion o un servidor MCP.

Requisitos

• Node.js 20 o superior.
• npm 10 o superior.
• Un proyecto TypeScript o JavaScript.
• Conexion a internet durante la instalacion y la primera indexacion de vectores.
• Opcional: un cliente compatible con MCP, como VS Code con Copilot, Antigravity, Claude Code u otro IDE/agente que soporte servidores MCP.

LaCoCo guarda sus indices dentro del proyecto, en el directorio .lacoco/.

Instalacion

npm install -g @joru/lacoco

Verifica la instalacion:

lacoco --version
lacoco --help

Para actualizar:

npm install -g @joru/lacoco@latest --registry=https://registry.npmjs.org/

Para desinstalar:

npm uninstall -g @joru/lacoco

Indexar un proyecto

Desde cualquier ubicacion puedes pasar la ruta del proyecto:

lacoco index_graph /ruta/al/proyecto
lacoco index_vectors /ruta/al/proyecto

Tambien puedes pasar un tsconfig.json especifico:

lacoco index_graph /ruta/al/proyecto/tsconfig.json
lacoco index_vectors /ruta/al/proyecto/tsconfig.json

Si pasas un directorio, LaCoCo busca automaticamente configuraciones TypeScript dentro de ese proyecto. Esto sirve tanto para proyectos simples como para repositorios con varios servicios.

Recuperar contexto

lacoco retrieve <proyecto> "describe aqui la tarea o problema"

Ejemplo:

lacoco retrieve mi-proyecto "arregla el flujo de cierre de tickets"

Puedes elegir una estrategia:

lacoco retrieve mi-proyecto "consulta" --strategy hybrid
lacoco retrieve mi-proyecto "consulta" --strategy consensus
lacoco retrieve mi-proyecto "consulta" --strategy connector

Estrategias disponibles:

• hybrid
• ictd
• clcr
• rpr
• consensus
• connector
• repograph
• ppr
• agentic

Inspeccion visual

Para generar un HTML con el contexto recuperado:

lacoco inspect-query <proyecto> "consulta" --output inspect.html

Puedes abrir el archivo inspect.html en el navegador.

Modos utiles:

lacoco inspect-query <proyecto> "consulta" --mode default --output inspect.html
lacoco inspect-query <proyecto> "consulta" --mode tensor --output inspect.html
lacoco inspect-query <proyecto> "consulta" --mode scores --output inspect.html

MCP

LaCoCo tambien puede ejecutarse como servidor MCP:

lacoco mcp /ruta/al/proyecto

Ejemplo de configuracion generica:

{
  "mcpServers": {
    "lacoco": {
      "command": "lacoco",
      "args": ["mcp", "/ruta/absoluta/al/proyecto"]
    }
  }
}

Usa siempre una ruta absoluta al proyecto para evitar problemas entre IDEs.

Comandos utiles

lacoco project list
lacoco project inspect <proyecto>
lacoco project remove <proyecto>
lacoco status <proyecto>

Problemas comunes

Si lacoco no aparece despues de instalar:

hash -r
which -a lacoco

Si el comando existe pero pertenece a una instalacion anterior, reinstala:

npm uninstall -g @joru/lacoco
npm install -g @joru/lacoco@latest --registry=https://registry.npmjs.org/
hash -r

Si un proyecto ya no existe pero aparece en lacoco project list, elimina su registro:

lacoco project remove <proyecto>