@generativereality/cctabs 0.3.1 → 0.3.2

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "cctabs",
   "description": "Claude Code tab manager. Terminal tabs as the UI, no tmux. Claude can orchestrate its own sibling sessions.",
-  "version": "0.3.1",
+  "version": "0.3.2",
   "author": {
     "name": "generativereality",
     "url": "https://cctabs.com"

package/README.md

@@ -206,11 +206,16 @@ flags = ["--allow-dangerously-skip-permissions"]
 | Terminal | Status |
 |----------|--------|
 | [Wave Terminal](https://waveterm.dev) | ✅ Full support |
+| [Tabby](https://tabby.sh) | ✅ Full support (requires the [`tabby-cctabs`](./tabby-plugin/) companion plugin) |
 | iTerm2 | Planned |
 | Ghostty | Planned |
 | Warp | Planned |
 
-Wave is supported via its unix socket RPC. Other terminals will follow as adapters — PRs welcome.
+Wave is supported via its unix socket RPC. Tabby is supported via a small companion plugin that exposes a localhost HTTP API the cctabs CLI talks to — install with `cctabs install-tabby-plugin`. Other terminals will follow as adapters — PRs welcome.
+
+### Login shells on macOS
+
+cctabs-spawned tabs default to **login shells** (`zsh -l`, `bash -l`, etc.) so PATH is initialised the same way Tabby's UI-spawned tabs are. Without `-l`, macOS's `/etc/zprofile` doesn't run, `path_helper` doesn't populate `/usr/local/bin` and `/opt/homebrew/bin` from `/etc/paths`, and brand-new tabs are missing Node, Homebrew, and anything else that lives there. Symptoms: `env: node: No such file or directory` in Claude Code's Bash tool, plugin MCP servers failing to start with ENOENT when they shell out to `npx`, and cctabs CLI itself failing inside the tab it just spawned. See [Tabby issue #2](https://github.com/Eugeny/tabby/issues/2) for the historical context. Pass an explicit `args` array (including `[]`) when calling the `/tabs` endpoint if you need a non-login shell.
 
 ## License
 

package/dist/index.js

@@ -11,7 +11,7 @@ import { consola } from "consola";
 import * as p from "@clack/prompts";
 //#region package.json
 var name = "@generativereality/cctabs";
-var version = "0.3.1";
+var version = "0.3.2";
 var description = "Claude Code tab manager. Terminal tabs as the UI, no tmux.";
 var package_default = {
 	name,
@@ -2601,6 +2601,38 @@ function checkTabbyPlugin() {
 		hint: "Run `cctabs install-tabby-plugin` from inside a Tabby tab — it npm-installs the plugin and reopens Tabby. Or do it by hand: `npm install --legacy-peer-deps --prefix \"$HOME/Library/Application Support/tabby/plugins\" tabby-cctabs`, then quit + reopen Tabby."
 	};
 }
+/**
+* Probe whether `node` is findable in a freshly spawned shell — the canonical
+* symptom of the macOS non-login PATH bug. Spawning `zsh -l -c 'command -v
+* node'` simulates the same login-shell init (/etc/zprofile → path_helper)
+* that cctabs now uses when it opens new Tabby tabs. If this fails, brand-new
+* tabs will also fail to find Node, every plugin MCP that shells out to npx
+* will ENOENT, and the cctabs CLI itself becomes unusable from inside those
+* tabs (chicken-and-egg). The remediation hint covers both the upstream-fix
+* path (rely on a recent cctabs that defaults to `-l`) and the dotfile
+* workaround for users on older versions or non-Tabby terminals.
+*/
+function checkSpawnedShellPath() {
+	const r = spawnSync("zsh", [
+		"-l",
+		"-c",
+		"command -v node"
+	], {
+		encoding: "utf-8",
+		timeout: 3e3
+	});
+	if (r.status === 0 && r.stdout?.trim()) return {
+		name: "Spawned shell PATH (node findable)",
+		status: "ok",
+		detail: r.stdout.trim()
+	};
+	return {
+		name: "Spawned shell PATH",
+		status: "warn",
+		detail: r.error?.message ?? r.stderr?.trim() ?? "node not found in a login zsh",
+		hint: "A login zsh cannot find `node`. Either node is not installed, or PATH is broken. On macOS, `/usr/local/bin` is added by /etc/zprofile's path_helper — non-login shells skip it. Add `export PATH=\"/usr/local/bin:$PATH\"` to ~/.zshenv as a belt-and-braces fix."
+	};
+}
 function checkWaveDb() {
 	if (!existsSync(WAVE_DB_PATH)) return { result: {
 		name: "Wave DB",
@@ -2705,6 +2737,7 @@ const doctorCommand = define({
 		const results = [];
 		let waveDb = null;
 		results.push(checkTerminal(terminal));
+		results.push(checkSpawnedShellPath());
 		if (terminal === "tabby") results.push(checkTabbyPlugin());
 		if (terminal === "wave") {
 			results.push(checkWaveAccessibility());
@@ -2852,7 +2885,7 @@ const defaultCommand = define({
 	description,
 	args: {},
 	async run() {
-		await sessionsCommand.run?.call(this, { args: {} });
+		await sessionsCommand.run?.call(this, { values: {} });
 	}
 });
 const subCommands = new Map([

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@generativereality/cctabs",
-  "version": "0.3.1",
+  "version": "0.3.2",
   "description": "Claude Code tab manager. Terminal tabs as the UI, no tmux.",
   "type": "module",
   "bin": {