token-pilot 0.30.0 → 0.30.1

package/docs/installation.md

@@ -1,6 +1,32 @@
 # Installation Guide
 
-## Quickest path
+## TL;DR
+
+**Claude Code — plugin (recommended):**
+```bash
+# New machine:
+claude plugin marketplace add https://github.com/Digital-Threads/token-pilot
+claude plugin install token-pilot@token-pilot
+
+# Update:
+claude plugin update token-pilot
+```
+
+**Other clients (Cursor, Codex, Cline, …):**
+```bash
+# New machine:
+npx -y token-pilot init
+
+# Update — npx always pulls fresh, just restart your client.
+# Or if installed globally:
+npm i -g token-pilot@latest
+npx token-pilot install-hook
+npx token-pilot install-agents --scope=user --force
+```
+
+---
+
+## First-time setup (full walkthrough)
 
 ```bash
 npx -y token-pilot init

package/hooks/hooks.json

@@ -19,6 +19,24 @@
           }
         ]
       },
+      {
+        "matcher": "MultiEdit",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node ${CLAUDE_PLUGIN_ROOT}/dist/index.js hook-edit"
+          }
+        ]
+      },
+      {
+        "matcher": "Write",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node ${CLAUDE_PLUGIN_ROOT}/dist/index.js hook-edit"
+          }
+        ]
+      },
       {
         "matcher": "Bash",
         "hooks": [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "token-pilot",
-  "version": "0.30.0",
+  "version": "0.30.1",
   "description": "Save up to 80% tokens when AI reads code — MCP server for token-efficient code navigation, AST-aware structural reading instead of dumping full files into context window",
   "type": "module",
   "main": "dist/index.js",

package/start.sh

@@ -5,24 +5,34 @@
 set -e
 
 SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+
+# Capture user's working directory BEFORE `cd $SCRIPT_DIR` — this is the
+# project root fallback when CLAUDE_PROJECT_DIR is not set. Without this,
+# `$(pwd)` below would resolve to the plugin cache dir and every relative
+# file path would be resolved inside the plugin install, not the project.
+USER_CWD="${PWD:-$(pwd)}"
+
 cd "$SCRIPT_DIR"
 
 # 1. Install runtime dependencies when the package is incomplete.
 if [ ! -f "node_modules/@modelcontextprotocol/sdk/package.json" ]; then
-  echo "[token-pilot] Installing runtime dependencies..." >&2
-  npm install --production --no-audit --no-fund 2>&1 >&2
+	echo "[token-pilot] Installing runtime dependencies..." >&2
+	npm install --production --no-audit --no-fund 2>&1 >&2
 fi
 
 # 2. Build if dist/ is missing.
 if [ ! -f "dist/index.js" ]; then
-  echo "[token-pilot] Building..." >&2
-  if [ ! -f "node_modules/typescript/bin/tsc" ]; then
-    npm install --no-audit --no-fund 2>&1 >&2
-  fi
-  npm run build 2>&1 >&2
+	echo "[token-pilot] Building..." >&2
+	if [ ! -f "node_modules/typescript/bin/tsc" ]; then
+		npm install --no-audit --no-fund 2>&1 >&2
+	fi
+	npm run build 2>&1 >&2
 fi
 
 # 3. Start the MCP server.
-# Pass CLAUDE_PROJECT_DIR as project root if available, otherwise cwd.
-PROJECT_ROOT="${CLAUDE_PROJECT_DIR:-$(pwd)}"
+# Priority for project root:
+#   1. CLAUDE_PROJECT_DIR  — set by Claude Code for the active workspace
+#   2. USER_CWD            — the user's shell working directory (captured pre-cd)
+# Passing the plugin cache dir here would poison every relative path lookup.
+PROJECT_ROOT="${CLAUDE_PROJECT_DIR:-$USER_CWD}"
 exec node "$SCRIPT_DIR/dist/index.js" "$PROJECT_ROOT"