diff --git a/.husky/commit-msg b/.husky/commit-msg
index 2769b33e4..210300aef 100644
--- a/.husky/commit-msg
+++ b/.husky/commit-msg
@@ -2,7 +2,7 @@
 npx --no -- commitlint --edit $1
 
 # Append codegraph impact summary if available
-IMPACT=$(codegraph diff-impact --staged --json -T 2>/dev/null || node src/cli.js diff-impact --staged --json -T 2>/dev/null || true)
+IMPACT=$(codegraph diff-impact --staged --json -T 2>/dev/null || node dist/cli.js diff-impact --staged --json -T 2>/dev/null || true)
 if [ -n "$IMPACT" ]; then
   SUMMARY=$(echo "$IMPACT" | node -e "
     let d=''; process.stdin.on('data',c=>d+=c);
diff --git a/.husky/pre-commit b/.husky/pre-commit
index 39971ef0e..89b517b8f 100644
--- a/.husky/pre-commit
+++ b/.husky/pre-commit
@@ -1,3 +1,3 @@
 #!/bin/sh
 npm run lint
-codegraph build 2>/dev/null || node src/cli.js build . 2>/dev/null || true
+codegraph build 2>/dev/null || node dist/cli.js build . 2>/dev/null || true
diff --git a/scripts/benchmark.ts b/scripts/benchmark.ts
index b49e96014..afb7ac841 100644
--- a/scripts/benchmark.ts
+++ b/scripts/benchmark.ts
@@ -7,7 +7,7 @@
  * in the native addon only kills the child — the parent survives and collects
  * partial results from whichever engines succeeded.
  *
- * Usage: node scripts/benchmark.js
+ * Usage: node --experimental-strip-types --import ./scripts/ts-resolve-loader.js scripts/benchmark.ts
  */
 
 import fs from 'node:fs';
diff --git a/scripts/build-wasm.ts b/scripts/build-wasm.ts
index 7a60987b2..87a7f5e19 100644
--- a/scripts/build-wasm.ts
+++ b/scripts/build-wasm.ts
@@ -3,7 +3,7 @@
 /**
  * Build WASM grammar files from tree-sitter grammar packages.
  *
- * Usage: node scripts/build-wasm.js
+ * Usage: node scripts/node-ts.js scripts/build-wasm.ts
  *
  * Requires devDependencies: tree-sitter-cli + grammar packages.
  * Outputs .wasm files into grammars/ (committed to repo).
diff --git a/scripts/embedding-benchmark.ts b/scripts/embedding-benchmark.ts
index a59c79a77..dd343e626 100644
--- a/scripts/embedding-benchmark.ts
+++ b/scripts/embedding-benchmark.ts
@@ -7,7 +7,7 @@
  * in the ONNX runtime) only kills the child — the parent survives and collects
  * partial results from whichever models succeeded.
  *
- * Usage: node scripts/embedding-benchmark.js > result.json
+ * Usage: node --experimental-strip-types --import ./scripts/ts-resolve-loader.js scripts/embedding-benchmark.ts > result.json
  */
 
 import fs from 'node:fs';
diff --git a/scripts/incremental-benchmark.ts b/scripts/incremental-benchmark.ts
index 974212352..2b6a6b27e 100644
--- a/scripts/incremental-benchmark.ts
+++ b/scripts/incremental-benchmark.ts
@@ -7,7 +7,7 @@
  * in the native addon only kills the child — the parent survives and collects
  * partial results from whichever engines succeeded.
  *
- * Usage: node scripts/incremental-benchmark.js > result.json
+ * Usage: node --experimental-strip-types --import ./scripts/ts-resolve-loader.js scripts/incremental-benchmark.ts > result.json
  */
 
 import fs from 'node:fs';
diff --git a/scripts/query-benchmark.ts b/scripts/query-benchmark.ts
index 032b15ca5..9f8c7eaa1 100644
--- a/scripts/query-benchmark.ts
+++ b/scripts/query-benchmark.ts
@@ -7,7 +7,7 @@
  * in the native addon only kills the child — the parent survives and collects
  * partial results from whichever engines succeeded.
  *
- * Usage: node scripts/query-benchmark.js > result.json
+ * Usage: node --experimental-strip-types --import ./scripts/ts-resolve-loader.js scripts/query-benchmark.ts > result.json
  */
 
 import { execFileSync } from 'node:child_process';