FAILED: community-tool:codegraph — install

[rbedani]

Pre-flight Checklist

• I have searched existing issues and this is not a duplicate
• I understand that PRs will be rejected if the linked issue does not have status:approved

📝 Bug Description

Hola alan, al ejecutar Gentle-AI 1.43.2 en mi equipo con ubuntu 22.04, surge un error:

Logs
FAILED: community-tool:codegraph — install community tool "codegraph": run "codegraph install --yes"
pipeline completed with errors

🔄 Steps to Reproduce

1. run gentle-ai
2. select codegraph

✅ Expected Behavior

completar la instalacion

❌ Actual Behavior

No se instala el plugin

Gentle AI Version

gga v2.8.1

Operating System

Linux (Ubuntu/Debian)

AI Agent / Client

OpenCode

📋 Affected Area

Installation Pipeline

💡 Logs / Error Output

Logs
  FAILED: community-tool:codegraph — install community tool "codegraph": run "codegraph install --yes"
  pipeline completed with errors

Additional Context

`System Detection

OS linux (arm64)
Shell bash
Supported Yes

Tools
brew: not found
curl: found
git: found
go: not found
node: found

Dependencies
git: 2.43.0
curl: 8.5.0
node: 22.22.3
npm: 10.9.8
go: not found (optional)

Detected Configs
claude-code: missing
opencode: present
kilocode: missing
gemini-cli: missing
cursor: missing
vscode-copilot: missing
codex: missing
antigravity: missing
windsurf: missing
kimi: missing
qwen-code: missing
kiro-ide: missing
openclaw: missing
pi: missing
trae-ide: missing
hermes: present

Continue`

[skiveldev]

Gracias por reportarlo. Para ayudar a aislar si el fallo viene de gentle-ai, de codegraph, o de soporte linux/arm64, haría falta un poco más de salida del comando que falla.

¿Podrías ejecutar esto y pegar el resultado completo?

codegraph install --yes
codegraph --version
which codegraph
node --version
npm --version
uname -m

También sería útil saber si codegraph install --yes falla igual fuera de gentle-ai. Con eso se puede distinguir si el problema está en la instalación del community tool o en cómo Gentle AI lo invoca.

[xxg4xx]

Hola vengo a reportar que tengo el mismo error:

Community tool setup failed                                                           ║
║  run "codegraph install --yes": exec: "codegraph": executable file not found in $PATH 

Estoy desde Omarchy - CachyOS.

[skiveldev]

Gracias por sumar ese dato. Ese error acota bastante el problema: gentle-ai está intentando ejecutar codegraph install --yes, pero el binario codegraph no existe en $PATH.

Para confirmar el alcance, sería útil saber si el flujo del community tool debería:

1. instalar primero el binario codegraph, y recién después ejecutar codegraph install --yes; o
2. validar que codegraph ya existe en $PATH y mostrar un mensaje accionable si falta.

Si pueden, peguen también la salida de:

which codegraph
command -v codegraph
echo $PATH

Con eso queda más claro si el bug está en el precheck/instalación del community tool o en una dependencia previa no documentada.

[rbedani]

perdón la demora.

no llega a instalar el binario:

codegraph install --yes
-bash: codegraph: command not found

[xxg4xx]

La causa raíz está en internal/components/communitytool/tool.go, en la función codeGraphCommands().
El instalador ejecuta dos comandos secuencialmente:

1. npm install -g @colbymchenry/codegraph@latest
2. codegraph install --yes

El segundo comando usa exec.LookPath("codegraph") para encontrar el binario. Cuando Node.js está manejado por mise, nvm o fnm, el directorio global de npm (npm bin -g) se resuelve a una ruta como ~/.local/share/mise/installs/node//bin/, que solo está disponible en shells interactivos mediante los scripts de init del version manager. exec.LookPath no la encuentra, y el comando falla.

Solución propuesta: después del npm install -g, resolver la ruta completa del binario vía npm bin -g en vez de confiar en exec.LookPath:

  out, err := exec.Command("npm", "bin", "-g").Output()
  if err == nil {
      binDir := strings.TrimSpace(string(out))
      runCommand = []string{filepath.Join(binDir, "codegraph"), "install", "--yes"}
  }

Workaround mientras tanto: ln -sf "$(npm bin -g)/codegraph" ~/.local/bin/codegraph

Si le ponen status:approved puedo mandar el PR con el fix. =)

[skiveldev]

Buen análisis, tiene sentido que el segundo paso no pueda depender solo de exec.LookPath(codegraph) si el binario recién instalado por npm queda en un directorio global que el proceso de gentle-ai no tiene en PATH.

Solo tendría cuidado con un detalle antes de fijar el approach: validar qué comando es compatible con las versiones de npm que soporta el proyecto. En algunas versiones modernas, npm bin -g puede no estar disponible o comportarse distinto, mientras que npm root -g apunta al directorio de paquetes, no necesariamente al directorio de binarios.

Quizás el PR podría cubrir esto con tests/seams para:

• PATH sin codegraph, pero npm global bin resolviendo el ejecutable;
• fallback con mensaje accionable si no se puede resolver el binario;
• no romper el caso simple donde codegraph ya está en PATH.

Eso dejaría el fix acotado al resolver el binario instalado, sin cambiar el contrato general del community tool.

[Alan-TheGentleman]

This is clear and in scope. Adding status:approved. A PR linking this issue with Closes #1003 is welcome.