not installing codegraph binary in linux ubuntu (mint 22)

[this1-it]

i've already installed mcp with nvm and node 22

npx @colbymchenry/codegraph

npx installer show warning on tree-sitter
did not install codegraph as binary
then on console
$ codegraph
Command 'codegraph' not found
eventually claude is not able to start mcp for codegraph

npx runs package withou install

I've tried package install
$ npm i @colbymchenry/codegraph
npm warn ERESOLVE overriding peer dependency
npm warn While resolving: tree-sitter-c-sharp@0.23.1
npm warn Found: tree-sitter@0.22.4
npm warn node_modules/tree-sitter
npm warn tree-sitter@"^0.22.4" from @colbymchenry/codegraph@0.3.1
npm warn node_modules/@colbymchenry/codegraph
npm warn @colbymchenry/codegraph@"" from the root project
npm warn 4 more (tree-sitter-c, tree-sitter-python, tree-sitter-rust, tree-sitter-swift)
npm warn
npm warn Could not resolve dependency:
npm warn peerOptional tree-sitter@"^0.21.1" from tree-sitter-c-sharp@0.23.1
npm warn node_modules/tree-sitter-c-sharp
npm warn tree-sitter-c-sharp@"^0.23.1" from @colbymchenry/codegraph@0.3.1
npm warn node_modules/@colbymchenry/codegraph
npm warn
npm warn Conflicting peer dependency: tree-sitter@0.21.1
npm warn node_modules/tree-sitter
npm warn peerOptional tree-sitter@"^0.21.1" from tree-sitter-c-sharp@0.23.1
npm warn node_modules/tree-sitter-c-sharp
npm warn tree-sitter-c-sharp@"^0.23.1" from @colbymchenry/codegraph@0.3.1
npm warn node_modules/@colbymchenry/codegraph
npm warn ERESOLVE overriding peer dependency
npm warn While resolving: tree-sitter-cpp@0.23.4
npm warn Found: tree-sitter@0.22.4
npm warn node_modules/tree-sitter
npm warn tree-sitter@"^0.22.4" from @colbymchenry/codegraph@0.3.1
npm warn node_modules/@colbymchenry/codegraph
npm warn @colbymchenry/codegraph@"" from the root project
npm warn 4 more (tree-sitter-c, tree-sitter-python, tree-sitter-rust, tree-sitter-swift)
npm warn
npm warn Could not resolve dependency:
npm warn peerOptional tree-sitter@"^0.21.1" from tree-sitter-cpp@0.23.4
npm warn node_modules/tree-sitter-cpp
npm warn tree-sitter-cpp@"^0.23.4" from @colbymchenry/codegraph@0.3.1
npm warn node_modules/@colbymchenry/codegraph
npm warn
npm warn Conflicting peer dependency: tree-sitter@0.21.1
npm warn node_modules/tree-sitter
npm warn peerOptional tree-sitter@"^0.21.1" from tree-sitter-cpp@0.23.4
npm warn node_modules/tree-sitter-cpp
npm warn tree-sitter-cpp@"^0.23.4" from @colbymchenry/codegraph@0.3.1
npm warn node_modules/@colbymchenry/codegraph
npm warn ERESOLVE overriding peer dependency
npm warn While resolving: tree-sitter-go@0.23.4
npm warn Found: tree-sitter@0.22.4
npm warn node_modules/tree-sitter
npm warn tree-sitter@"^0.22.4" from @colbymchenry/codegraph@0.3.1
npm warn node_modules/@colbymchenry/codegraph
npm warn @colbymchenry/codegraph@"" from the root project
npm warn 4 more (tree-sitter-c, tree-sitter-python, tree-sitter-rust, tree-sitter-swift)
npm warn
npm warn Could not resolve dependency:
npm warn peerOptional tree-sitter@"^0.21.1" from tree-sitter-go@0.23.4
npm warn node_modules/tree-sitter-go
npm warn tree-sitter-go@"^0.23.4" from @colbymchenry/codegraph@0.3.1
npm warn node_modules/@colbymchenry/codegraph
npm warn
npm warn Conflicting peer dependency: tree-sitter@0.21.1
npm warn node_modules/tree-sitter
npm warn peerOptional tree-sitter@"^0.21.1" from tree-sitter-go@0.23.4
npm warn node_modules/tree-sitter-go
npm warn tree-sitter-go@"^0.23.4" from @colbymchenry/codegraph@0.3.1
npm warn node_modules/@colbymchenry/codegraph
npm warn ERESOLVE overriding peer dependency
npm warn While resolving: tree-sitter-java@0.23.5
npm warn Found: tree-sitter@0.22.4
npm warn node_modules/tree-sitter
npm warn tree-sitter@"^0.22.4" from @colbymchenry/codegraph@0.3.1
npm warn node_modules/@colbymchenry/codegraph
npm warn @colbymchenry/codegraph@"" from the root project
npm warn 4 more (tree-sitter-c, tree-sitter-python, tree-sitter-rust, tree-sitter-swift)
npm warn
npm warn Could not resolve dependency:
npm warn peerOptional tree-sitter@"^0.21.1" from tree-sitter-java@0.23.5
npm warn node_modules/tree-sitter-java
npm warn tree-sitter-java@"^0.23.5" from @colbymchenry/codegraph@0.3.1
npm warn node_modules/@colbymchenry/codegraph
npm warn
npm warn Conflicting peer dependency: tree-sitter@0.21.1
npm warn node_modules/tree-sitter
npm warn peerOptional tree-sitter@"^0.21.1" from tree-sitter-java@0.23.5
npm warn node_modules/tree-sitter-java
npm warn tree-sitter-java@"^0.23.5" from @colbymchenry/codegraph@0.3.1
npm warn node_modules/@colbymchenry/codegraph
npm warn ERESOLVE overriding peer dependency
npm warn While resolving: tree-sitter-javascript@0.23.1
npm warn Found: tree-sitter@0.22.4
npm warn node_modules/tree-sitter
npm warn tree-sitter@"^0.22.4" from @colbymchenry/codegraph@0.3.1
npm warn node_modules/@colbymchenry/codegraph
npm warn @colbymchenry/codegraph@"" from the root project
npm warn 4 more (tree-sitter-c, tree-sitter-python, tree-sitter-rust, tree-sitter-swift)
npm warn
npm warn Could not resolve dependency:
npm warn peerOptional tree-sitter@"^0.21.1" from tree-sitter-javascript@0.23.1
npm warn node_modules/tree-sitter-javascript
npm warn tree-sitter-javascript@"^0.23.1" from @colbymchenry/codegraph@0.3.1
npm warn node_modules/@colbymchenry/codegraph
npm warn 1 more (tree-sitter-typescript)
npm warn
npm warn Conflicting peer dependency: tree-sitter@0.21.1
npm warn node_modules/tree-sitter
npm warn peerOptional tree-sitter@"^0.21.1" from tree-sitter-javascript@0.23.1
npm warn node_modules/tree-sitter-javascript
npm warn tree-sitter-javascript@"^0.23.1" from @colbymchenry/codegraph@0.3.1
npm warn node_modules/@colbymchenry/codegraph
npm warn 1 more (tree-sitter-typescript)
npm warn ERESOLVE overriding peer dependency
npm warn While resolving: tree-sitter-kotlin@0.3.8
npm warn Found: tree-sitter@0.22.4
npm warn node_modules/tree-sitter
npm warn tree-sitter@"^0.22.4" from @colbymchenry/codegraph@0.3.1
npm warn node_modules/@colbymchenry/codegraph
npm warn @colbymchenry/codegraph@"" from the root project
npm warn 4 more (tree-sitter-c, tree-sitter-python, tree-sitter-rust, tree-sitter-swift)
npm warn
npm warn Could not resolve dependency:
npm warn peer tree-sitter@"^0.21.0" from tree-sitter-kotlin@0.3.8
npm warn node_modules/tree-sitter-kotlin
npm warn tree-sitter-kotlin@"^0.3.8" from @colbymchenry/codegraph@0.3.1
npm warn node_modules/@colbymchenry/codegraph
npm warn
npm warn Conflicting peer dependency: tree-sitter@0.21.1
npm warn node_modules/tree-sitter
npm warn peer tree-sitter@"^0.21.0" from tree-sitter-kotlin@0.3.8
npm warn node_modules/tree-sitter-kotlin
npm warn tree-sitter-kotlin@"^0.3.8" from @colbymchenry/codegraph@0.3.1
npm warn node_modules/@colbymchenry/codegraph
npm warn ERESOLVE overriding peer dependency
npm warn While resolving: tree-sitter-liquid@0.1.0
npm warn Found: tree-sitter@0.22.4
npm warn node_modules/tree-sitter
npm warn tree-sitter@"^0.22.4" from @colbymchenry/codegraph@0.3.1
npm warn node_modules/@colbymchenry/codegraph
npm warn @colbymchenry/codegraph@"" from the root project
npm warn 4 more (tree-sitter-c, tree-sitter-python, tree-sitter-rust, tree-sitter-swift)
npm warn
npm warn Could not resolve dependency:
npm warn peer tree-sitter@"^0.21.1" from tree-sitter-liquid@0.1.0
npm warn node_modules/tree-sitter-liquid
npm warn tree-sitter-liquid@"github:hankthetank27/tree-sitter-liquid" from @colbymchenry/codegraph@0.3.1
npm warn node_modules/@colbymchenry/codegraph
npm warn
npm warn Conflicting peer dependency: tree-sitter@0.21.1
npm warn node_modules/tree-sitter
npm warn peer tree-sitter@"^0.21.1" from tree-sitter-liquid@0.1.0
npm warn node_modules/tree-sitter-liquid
npm warn tree-sitter-liquid@"github:hankthetank27/tree-sitter-liquid" from @colbymchenry/codegraph@0.3.1
npm warn node_modules/@colbymchenry/codegraph
npm warn ERESOLVE overriding peer dependency
npm warn While resolving: tree-sitter-php@0.23.12
npm warn Found: tree-sitter@0.22.4
npm warn node_modules/tree-sitter
npm warn tree-sitter@"^0.22.4" from @colbymchenry/codegraph@0.3.1
npm warn node_modules/@colbymchenry/codegraph
npm warn @colbymchenry/codegraph@"" from the root project
npm warn 4 more (tree-sitter-c, tree-sitter-python, tree-sitter-rust, tree-sitter-swift)
npm warn
npm warn Could not resolve dependency:
npm warn peerOptional tree-sitter@"^0.21.1" from tree-sitter-php@0.23.12
npm warn node_modules/tree-sitter-php
npm warn tree-sitter-php@"^0.23.11" from @colbymchenry/codegraph@0.3.1
npm warn node_modules/@colbymchenry/codegraph
npm warn
npm warn Conflicting peer dependency: tree-sitter@0.21.1
npm warn node_modules/tree-sitter
npm warn peerOptional tree-sitter@"^0.21.1" from tree-sitter-php@0.23.12
npm warn node_modules/tree-sitter-php
npm warn tree-sitter-php@"^0.23.11" from @colbymchenry/codegraph@0.3.1
npm warn node_modules/@colbymchenry/codegraph
npm warn ERESOLVE overriding peer dependency
npm warn While resolving: tree-sitter-ruby@0.23.1
npm warn Found: tree-sitter@0.22.4
npm warn node_modules/tree-sitter
npm warn tree-sitter@"^0.22.4" from @colbymchenry/codegraph@0.3.1
npm warn node_modules/@colbymchenry/codegraph
npm warn @colbymchenry/codegraph@"" from the root project
npm warn 4 more (tree-sitter-c, tree-sitter-python, tree-sitter-rust, tree-sitter-swift)
npm warn
npm warn Could not resolve dependency:
npm warn peerOptional tree-sitter@"^0.21.1" from tree-sitter-ruby@0.23.1
npm warn node_modules/tree-sitter-ruby
npm warn tree-sitter-ruby@"^0.23.1" from @colbymchenry/codegraph@0.3.1
npm warn node_modules/@colbymchenry/codegraph
npm warn
npm warn Conflicting peer dependency: tree-sitter@0.21.1
npm warn node_modules/tree-sitter
npm warn peerOptional tree-sitter@"^0.21.1" from tree-sitter-ruby@0.23.1
npm warn node_modules/tree-sitter-ruby
npm warn tree-sitter-ruby@"^0.23.1" from @colbymchenry/codegraph@0.3.1
npm warn node_modules/@colbymchenry/codegraph
npm warn ERESOLVE overriding peer dependency
npm warn While resolving: tree-sitter-typescript@0.23.2
npm warn Found: tree-sitter@0.22.4
npm warn node_modules/tree-sitter
npm warn tree-sitter@"^0.22.4" from @colbymchenry/codegraph@0.3.1
npm warn node_modules/@colbymchenry/codegraph
npm warn @colbymchenry/codegraph@"" from the root project
npm warn 4 more (tree-sitter-c, tree-sitter-python, tree-sitter-rust, tree-sitter-swift)
npm warn
npm warn Could not resolve dependency:
npm warn peerOptional tree-sitter@"^0.21.0" from tree-sitter-typescript@0.23.2
npm warn node_modules/tree-sitter-typescript
npm warn tree-sitter-typescript@"^0.23.2" from @colbymchenry/codegraph@0.3.1
npm warn node_modules/@colbymchenry/codegraph
npm warn
npm warn Conflicting peer dependency: tree-sitter@0.21.1
npm warn node_modules/tree-sitter
npm warn peerOptional tree-sitter@"^0.21.0" from tree-sitter-typescript@0.23.2
npm warn node_modules/tree-sitter-typescript
npm warn tree-sitter-typescript@"^0.23.2" from @colbymchenry/codegraph@0.3.1
npm warn node_modules/@colbymchenry/codegraph

added 122 packages, and audited 123 packages in 1m

10 packages are looking for funding
run npm fund for details

found 0 vulnerabilities

$ codegraph
Command 'codegraph' not found, did you mean:
command 'codecgraph' from deb codecgraph (20120114-5build4)
Try: sudo apt install

[GaborNyul]

If you use npm install -g @colbymchenry/codegraph you will see the reason (at least on Ubuntu 24.04):

npm error code 127
npm error git dep preparation failed
npm error command /home/xxx/.nvm/versions/node/v24.12.0/bin/node /home/xxx/.nvm/versions/node/v24.12.0/lib/node_modules/npm/bin/npm-cli.js install --force --cache=/home/xxx/.npm --prefer-offline=false --prefer-online=false --offline=false --no-progress --no-save --no-audit --include=dev --include=peer --include=optional --no-package-lock-only --no-dry-run
npm error npm warn using --force Recommended protections disabled.
npm error npm error code 127
npm error npm error path /home/xxx/.npm/_cacache/tmp/git-clone5PU8Ol
npm error npm error command failed
npm error npm error command sh -c node-gyp-build
npm error npm error sh: 1: node-gyp-build: not found
npm error npm error A complete log of this run can be found in: /home/xxx/.npm/_logs/2026-02-05T21_30_50_160Z-debug-0.log
npm error A complete log of this run can be found in: /home/xxx/.npm/_logs/2026-02-05T21_30_43_122Z-debug-0.log

To get this point I had to install node-gyp: npm install -g node-gyp. Prior to that it was failing with other error.

So far I am stuck at this point.

[GaborNyul]

npm install -g node-gyp-build node-addon-api made it further. But now complains cannot find node-addon-api.
node: v24.12.0
npm: 11.9.0
os: Ubuntu 24.04

[GaborNyul]

Btw. On Win11 it complains cannot find Visual Studio 2026 community edition is installed.

[dougis]

Its an LTS vs current Node issue, if you use Node 22 and make sure to wipe things out, it installs

# 1. Switch to LTS
nvm install 22
nvm use 22

# 2. Force npm to forget the failed v25 attempts
npm cache clean --force

# 3. Run the installer
 npx @colbymchenry/codegraph

[this1-it]

Its an LTS vs current Node issue, if you use Node 22 and make sure to wipe things out, it installs

no way
installed lts/jod -> v22.22.0
I've run installer but codegraph binary is not available

[ilpanich]

Its an LTS vs current Node issue, if you use Node 22 and make sure to wipe things out, it installs

no way installed lts/jod -> v22.22.0 I've run installer but codegraph binary is not available

Also for me, stuck on Node v22.22.0 on Archlinux:

npm warn Conflicting peer dependency: tree-sitter@0.21.1
npm warn node_modules/tree-sitter
npm warn peerOptional tree-sitter@"^0.21.0" from tree-sitter-typescript@0.23.2
npm warn node_modules/@colbymchenry/codegraph/node_modules/tree-sitter-typescript
npm warn tree-sitter-typescript@"^0.23.2" from @colbymchenry/codegraph@0.3.1
npm warn node_modules/@colbymchenry/codegraph
npm error code 1
npm error git dep preparation failed
npm error command /usr/bin/node /usr/lib/node_modules/npm/bin/npm-cli.js install --force --cache=/root/.npm --prefer-offline=false --prefer-online=false --offline=false --no-progress --no-save --no-audit --include=dev --include=peer --include=optional --no-package-lock-only --no-dry-run
npm error npm warn using --force Recommended protections disabled.
npm error npm error code 1
npm error npm error path /root/.npm/_cacache/tmp/git-clonezOTKvd
npm error npm error command failed
npm error npm error command sh -c node-gyp-build
npm error npm error gyp info it worked if it ends with ok
npm error npm error gyp info using node-gyp@12.2.0
npm error npm error gyp info using node@22.22.0 | linux | x64
npm error npm error gyp info find Python using Python version 3.14.2 found at "/home/emanuele/bin/python3"
npm error npm error gyp info spawn /home/emanuele/bin/python3
npm error npm error gyp info spawn args [
npm error npm error gyp info spawn args '/usr/lib/node_modules/node-gyp/gyp/gyp_main.py',
npm error npm error gyp info spawn args 'binding.gyp',
npm error npm error gyp info spawn args '-f',
npm error npm error gyp info spawn args 'make',
npm error npm error gyp info spawn args '-I',
npm error npm error gyp info spawn args '/root/.npm/_cacache/tmp/git-clonezOTKvd/build/config.gypi',
npm error npm error gyp info spawn args '-I',
npm error npm error gyp info spawn args '/usr/lib/node_modules/node-gyp/addon.gypi',
npm error npm error gyp info spawn args '-I',
npm error npm error gyp info spawn args '/root/.cache/node-gyp/22.22.0/include/node/common.gypi',
npm error npm error gyp info spawn args '-Dlibrary=shared_library',
npm error npm error gyp info spawn args '-Dvisibility=default',
npm error npm error gyp info spawn args '-Dnode_root_dir=/root/.cache/node-gyp/22.22.0',
npm error npm error gyp info spawn args '-Dnode_gyp_dir=/usr/lib/node_modules/node-gyp',
npm error npm error gyp info spawn args '-Dnode_lib_file=/root/.cache/node-gyp/22.22.0/<(target_arch)/node.lib',
npm error npm error gyp info spawn args '-Dmodule_root_dir=/root/.npm/_cacache/tmp/git-clonezOTKvd',
npm error npm error gyp info spawn args '-Dnode_engine=v8',
npm error npm error gyp info spawn args '--depth=.',
npm error npm error gyp info spawn args '--no-parallel',
npm error npm error gyp info spawn args '--generator-output',
npm error npm error gyp info spawn args 'build',
npm error npm error gyp info spawn args '-Goutput_dir=.'
npm error npm error gyp info spawn args ]
npm error npm error node:internal/modules/cjs/loader:1386
npm error npm error throw err;
npm error npm error ^
npm error npm error
npm error npm error Error: Cannot find module 'node-addon-api'
npm error npm error Require stack:
npm error npm error - /root/.npm/_cacache/tmp/git-clonezOTKvd/[eval]
npm error npm error at Function._resolveFilename (node:internal/modules/cjs/loader:1383:15)
npm error npm error at defaultResolveImpl (node:internal/modules/cjs/loader:1025:19)
npm error npm error at resolveForCJSWithHooks (node:internal/modules/cjs/loader:1030:22)
npm error npm error at Function._load (node:internal/modules/cjs/loader:1192:37)
npm error npm error at TracingChannel.traceSync (node:diagnostics_channel:328:14)
npm error npm error at wrapModuleLoad (node:internal/modules/cjs/loader:237:24)
npm error npm error at Module.require (node:internal/modules/cjs/loader:1463:12)
npm error npm error at require (node:internal/modules/helpers:147:16)
npm error npm error at [eval]:1:1
npm error npm error at runScriptInThisContext (node:internal/vm:209:10) {
npm error npm error code: 'MODULE_NOT_FOUND',
npm error npm error requireStack: [ '/root/.npm/_cacache/tmp/git-clonezOTKvd/[eval]' ]
npm error npm error }
npm error npm error
npm error npm error Node.js v22.22.0
npm error npm error gyp: Call to 'node -p "require('node-addon-api').targets"' returned exit status 1 while in binding.gyp. while trying to load binding.gyp
npm error npm error gyp ERR! configure error
npm error npm error gyp ERR! stack Error: gyp failed with exit code: 1
npm error npm error gyp ERR! stack at ChildProcess. (/usr/lib/node_modules/node-gyp/lib/configure.js:317:18)
npm error npm error gyp ERR! stack at ChildProcess.emit (node:events:519:28)
npm error npm error gyp ERR! stack at ChildProcess._handle.onexit (node:internal/child_process:293:12)
npm error npm error gyp ERR! System Linux 6.18.8-arch2-1
npm error npm error gyp ERR! command "/usr/bin/node" "/usr/lib/node_modules/node-gyp/bin/node-gyp.js" "rebuild"
npm error npm error gyp ERR! cwd /root/.npm/_cacache/tmp/git-clonezOTKvd
npm error npm error gyp ERR! node -v v22.22.0
npm error npm error gyp ERR! node-gyp -v v12.2.0
npm error npm error gyp ERR! $npm_package_name tree-sitter-liquid
npm error npm error gyp ERR! $npm_package_version 0.1.0
npm error npm error gyp ERR! not ok

[dougis]

I got further but then the MCP wouldn't initialize, I went back to using deepcontext :-(

[colbymchenry]

Fixed. Every error trace here points to tree-sitter-liquid failing to compile via node-gyp-build — on Ubuntu, Arch Linux, and Windows alike. We've removed tree-sitter-liquid from the package entirely (it had ABI incompatibility with tree-sitter 0.22+ anyway). Liquid support is handled by a built-in regex extractor that requires no native compilation.

We also moved sqlite-vss to optional dependencies since it has similar native build issues on some platforms.

Regarding the codegraph binary not being found — that's expected when using npm i (local install). Use npm i -g @colbymchenry/codegraph for the global binary, or run via npx @colbymchenry/codegraph.

These fixes are on main and will be in the next published version.