fix(cli): resolve exit code 127 when launching CLI dashboard from VS Code

CAL · CAL · commit a13af5f4dd70 · 2026-02-23T00:46:14.000+03:00
The terminal created with shellPath bypasses shell initialization, so
nvm/volta node binaries are not in PATH. Inject the CLI's bin directory
into the terminal env so #!/usr/bin/env node resolves correctly.

Also adds ~/.nvm/versions/node/*/bin/ to common path discovery.
diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml
@@ -72,8 +72,17 @@ jobs:
       - name: Run tests
         run: npm test
 
+      - name: Package .vsix
+        run: npx @vscode/vsce package -o sidekick-for-max-${{ needs.validate.outputs.version }}.vsix
+
+      - name: Upload .vsix artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: vsix
+          path: sidekick-vscode/sidekick-for-max-${{ needs.validate.outputs.version }}.vsix
+
       - name: Publish to Open VSX
-        run: npx ovsx publish || echo "Already published — continuing"
+        run: npx ovsx publish sidekick-for-max-${{ needs.validate.outputs.version }}.vsix || echo "Already published — continuing"
         env:
           OVSX_PAT: ${{ secrets.OVSX_PAT }}
 
@@ -126,11 +135,16 @@ jobs:
   create-release:
     name: Create GitHub Release
     runs-on: ubuntu-latest
-    needs: [validate, publish-npm]
+    needs: [validate, publish-extension, publish-npm]
 
     steps:
       - uses: actions/checkout@v4
 
+      - name: Download .vsix artifact
+        uses: actions/download-artifact@v4
+        with:
+          name: vsix
+
       - name: Extract changelog section
         id: changelog
         run: |
@@ -157,10 +171,12 @@ jobs:
 
             ## Install
 
-            **VS Code extension**: Install from [Open VSX](https://open-vsx.org/extension/CesarAndresLopez/sidekick-for-max).
+            **VS Code extension**: Download the `.vsix` below or install from [Open VSX](https://open-vsx.org/extension/CesarAndresLopez/sidekick-for-max).
 
             **CLI via npm** (requires Node.js 20+):
             ```
             npm i -g sidekick-agent-hub
             ```
+          files: |
+            sidekick-for-max-${{ needs.validate.outputs.version }}.vsix
           fail_on_unmatched_files: false
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -5,6 +5,13 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.12.1] - 2026-02-23
+
+### Fixed
+
+- **CLI dashboard launch from VS Code**: Fixed exit code 127 when launching the CLI dashboard via the extension button on systems using nvm, volta, or other Node version managers. The terminal now injects the CLI's directory into `PATH` so the node binary is found even when shell init is bypassed.
+- **CLI discovery for nvm users**: Added nvm installation paths (`~/.nvm/versions/node/*/bin/`) to the common path scan so the CLI is discovered without relying on `which`.
+
 ## [0.12.0] - 2026-02-22
 
 ### Added
diff --git a/docs/changelog.md b/docs/changelog.md
@@ -5,6 +5,14 @@ All notable changes to Sidekick Agent Hub (VS Code extension and CLI) will be do
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.12.1] - 2026-02-23
+
+### Fixed
+
+- **CLI dashboard launch from VS Code**: Fixed exit code 127 when launching the CLI dashboard via the "Open CLI Dashboard" command on systems using nvm, volta, or other Node version managers. The terminal now injects the CLI's bin directory into `PATH` so the `node` binary is found when shell init is bypassed by `shellPath`.
+- **CLI discovery for nvm users**: Added nvm installation paths (`~/.nvm/versions/node/*/bin/`) to the common path scan so the CLI is discovered without relying on `which`.
+- **GitHub Release assets**: The `.vsix` extension file is now attached to each GitHub Release for direct download.
+
 ## [0.12.0] - 2026-02-22
 
 ### Added
diff --git a/sidekick-cli/CHANGELOG.md b/sidekick-cli/CHANGELOG.md
@@ -5,6 +5,12 @@ All notable changes to the Sidekick Agent Hub CLI will be documented in this fil
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.12.1] - 2026-02-23
+
+### Fixed
+
+- **VS Code integration**: Fixed exit code 127 when the extension launches the CLI dashboard on systems using nvm or volta (node binary not found when shell init is bypassed)
+
 ## [0.12.0] - 2026-02-22
 
 ### Added
diff --git a/sidekick-cli/package-lock.json b/sidekick-cli/package-lock.json
diff --git a/sidekick-cli/package.json b/sidekick-cli/package.json
@@ -1,6 +1,6 @@
 {
   "name": "sidekick-agent-hub",
-  "version": "0.12.0",
+  "version": "0.12.1",
   "description": "Terminal dashboard for monitoring AI coding agent sessions",
   "type": "module",
   "bin": {
diff --git a/sidekick-shared/package-lock.json b/sidekick-shared/package-lock.json
diff --git a/sidekick-shared/package.json b/sidekick-shared/package.json
@@ -1,6 +1,6 @@
 {
   "name": "sidekick-shared",
-  "version": "0.12.0",
+  "version": "0.12.1",
   "description": "Shared data access layer for Sidekick — readers, types, providers",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
diff --git a/sidekick-vscode/CHANGELOG.md b/sidekick-vscode/CHANGELOG.md
@@ -5,6 +5,13 @@ All notable changes to the Sidekick Agent Hub VS Code extension will be document
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.12.1] - 2026-02-23
+
+### Fixed
+
+- **CLI dashboard launch from VS Code**: Fixed exit code 127 when launching the CLI dashboard via the "Open CLI Dashboard" command on systems using nvm, volta, or other Node version managers. The terminal now injects the CLI's bin directory into `PATH` so the `node` binary is found when shell init is bypassed by `shellPath`.
+- **CLI discovery for nvm users**: Added nvm installation paths (`~/.nvm/versions/node/*/bin/`) to the common path scan so the CLI is discovered without relying on `which`.
+
 ## [0.12.0] - 2026-02-22
 
 ### Added
diff --git a/sidekick-vscode/package.json b/sidekick-vscode/package.json
@@ -2,7 +2,7 @@
   "name": "sidekick-for-max",
   "displayName": "Sidekick Agent Hub",
   "description": "AI coding assistant with real-time agent monitoring — see what your AI is doing, control token costs, and never lose session context.",
-  "version": "0.12.0",
+  "version": "0.12.1",
   "publisher": "CesarAndresLopez",
   "author": {
     "name": "Cesar Andres Lopez",
diff --git a/sidekick-vscode/src/services/SidekickCliService.test.ts b/sidekick-vscode/src/services/SidekickCliService.test.ts
@@ -136,11 +136,14 @@ describe('SidekickCliService', () => {
 
       openCliDashboard({ workspacePath: '/my/project', providerId: 'claude-code' });
 
-      expect(mockCreateTerminal).toHaveBeenCalledWith({
-        name: 'Sidekick Dashboard',
-        shellPath: '/usr/local/bin/sidekick',
-        shellArgs: ['dashboard', '--project', '/my/project', '--provider', 'claude-code'],
-      });
+      expect(mockCreateTerminal).toHaveBeenCalledWith(
+        expect.objectContaining({
+          name: 'Sidekick Dashboard',
+          shellPath: '/usr/local/bin/sidekick',
+          shellArgs: ['dashboard', '--project', '/my/project', '--provider', 'claude-code'],
+          env: expect.objectContaining({ PATH: expect.stringContaining('/usr/local/bin') }),
+        }),
+      );
     });
 
     it('omits optional args when not provided', () => {
@@ -151,11 +154,14 @@ describe('SidekickCliService', () => {
 
       openCliDashboard();
 
-      expect(mockCreateTerminal).toHaveBeenCalledWith({
-        name: 'Sidekick Dashboard',
-        shellPath: '/usr/local/bin/sidekick',
-        shellArgs: ['dashboard'],
-      });
+      expect(mockCreateTerminal).toHaveBeenCalledWith(
+        expect.objectContaining({
+          name: 'Sidekick Dashboard',
+          shellPath: '/usr/local/bin/sidekick',
+          shellArgs: ['dashboard'],
+          env: expect.objectContaining({ PATH: expect.stringContaining('/usr/local/bin') }),
+        }),
+      );
     });
 
     it('reuses existing terminal if still alive', () => {
diff --git a/sidekick-vscode/src/services/SidekickCliService.ts b/sidekick-vscode/src/services/SidekickCliService.ts
@@ -30,7 +30,23 @@ function getCommonSidekickPaths(): string[] {
   const ext = isWindows ? '.cmd' : '';
   const bin = `sidekick${ext}`;
 
+  // nvm: detect current node version directory
+  const nvmPaths: string[] = [];
+  const nvmDir = path.join(homeDir, '.nvm', 'versions', 'node');
+  if (!isWindows && fs.existsSync(nvmDir)) {
+    try {
+      const versions = fs.readdirSync(nvmDir).sort().reverse();
+      for (const v of versions) {
+        nvmPaths.push(path.join(nvmDir, v, 'bin', bin));
+      }
+    } catch {
+      // nvm dir not readable
+    }
+  }
+
   return [
+    // nvm (most recent versions first)
+    ...nvmPaths,
     // npm global
     path.join(homeDir, '.npm-global', 'bin', bin),
     path.join(homeDir, 'npm-global', 'bin', bin),
@@ -157,10 +173,20 @@ export function openCliDashboard(options?: OpenCliDashboardOptions): void {
     args.push('--provider', options.providerId);
   }
 
+  // Inject the CLI's directory into PATH so the node binary (co-located in
+  // nvm/volta/etc. bin dirs) is found when the shim uses #!/usr/bin/env node.
+  // Without this, shellPath bypasses shell init and node may not be in PATH.
+  const cliDir = path.dirname(cliPath);
+  const env: Record<string, string> = {};
+  if (cliDir && cliDir !== '.') {
+    env['PATH'] = `${cliDir}${path.delimiter}${process.env.PATH || ''}`;
+  }
+
   dashboardTerminal = vscode.window.createTerminal({
     name: TERMINAL_NAME,
     shellPath: cliPath,
     shellArgs: args,
+    env,
   });
   dashboardTerminal.show();
 }

Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "sidekick-agent-hub",`
`3`		`- "version": "0.12.0",`
	`3`	`+ "version": "0.12.1",`
`4`	`4`	`"description": "Terminal dashboard for monitoring AI coding agent sessions",`
`5`	`5`	`"type": "module",`
`6`	`6`	`"bin": {`
Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "sidekick-shared",`
`3`		`- "version": "0.12.0",`
	`3`	`+ "version": "0.12.1",`
`4`	`4`	`"description": "Shared data access layer for Sidekick — readers, types, providers",`
`5`	`5`	`"main": "dist/index.js",`
`6`	`6`	`"types": "dist/index.d.ts",`