@halfwhey/claudraband 0.5.0 → 0.6.1

package/README.md

@@ -17,8 +17,8 @@ Claude Code for the power user
 
 It provides:
 
-- Resumable non-interactive workflows. Essentially claude -p with session support: cband continue <session-id> 'what was the result of the research?'
-- An http daemon for remote or headless session control
+- Resumable non-interactive workflows. Essentially `claude -p` with session support: `cband continue <session-id> 'what was the result of the research?'`
+- An HTTP daemon for remote or headless session control
 - An ACP server for editor and alternate frontend integration
 - A TypeScript library for building these workflows into your own tools
 
@@ -73,7 +73,7 @@ cband continue <session-id> --select 2
 
 The daemon defaults to using `tmux` as the terminal runtime, just like the local path. Use `--connect` only when creating a new daemon-backed session; after that, tracked `continue`, `attach`, and `sessions` route through the recorded live owner automatically.
 
-## Experimental Xterm Backend
+## Experimental xterm.js Backend
 
 `--backend xterm` exists for local or daemon use, but it is experimental and slower than `tmux`. Use it when you need a headless fallback, not as the default path for long-lived interactive work. See [docs/cli.md](docs/cli.md) for current caveats and backend behavior.
 

package/dist/bin.js

@@ -397,6 +397,9 @@ function hasSession(name) {
 function hasPane(id) {
   return spawnSync2("bash", ["-lc", shellCommand("tmux", "display-message", "-p", "-t", id, "#{pane_id}")], { stdio: "pipe" }).status === 0;
 }
+function windowTarget(sessionName, windowName) {
+  return `${sessionName}:${windowName}`;
+}
 async function killSession(name) {
   if (!hasSession(name))
     return;
@@ -443,15 +446,12 @@ class Session {
       throw new Error("tmuxctl: command is required");
     }
     const format = "#{window_id}\t#{pane_id}";
-    const result = hasSession(name) ? await tmux("new-window", "-P", "-F", format, "-t", name, "-n", windowName, ...workingDir ? ["-c", workingDir] : [], ...command) : await tmux("new-session", "-d", "-P", "-F", format, "-s", name, "-n", windowName, "-x", String(width), "-y", String(height), ...workingDir ? ["-c", workingDir] : [], ...command);
+    const target = windowTarget(name, windowName);
+    const result = hasSession(name) ? await tmux("new-window", "-P", "-F", format, "-t", name, "-n", windowName, ...workingDir ? ["-c", workingDir] : [], ...command, ";", "set-option", "-q", "-t", name, "destroy-unattached", "off", ";", "set-option", "-q", "-t", name, "status", "off", ";", "resize-window", "-t", target, "-x", String(width), "-y", String(height)) : await tmux("new-session", "-d", "-P", "-F", format, "-s", name, "-n", windowName, "-x", String(width), "-y", String(height), ...workingDir ? ["-c", workingDir] : [], ...command, ";", "set-option", "-q", "-t", name, "destroy-unattached", "off", ";", "set-option", "-q", "-t", name, "status", "off", ";", "resize-window", "-t", target, "-x", String(width), "-y", String(height));
     const [windowId, paneId] = result.stdout.trim().split(/\s+/, 2);
     if (!windowId || !paneId) {
       throw new Error(`tmuxctl: failed to parse tmux target ids: ${result.stdout}`);
     }
-    try {
-      await tmux("set-option", "-t", name, "status", "off");
-    } catch {}
-    await tmux("resize-window", "-t", windowId, "-x", String(width), "-y", String(height));
     return new Session(name, command, windowId, paneId);
   }
   static async find(sessionName, windowName) {
@@ -5285,6 +5285,13 @@ function resolveClaudeExecutable(explicitPath) {
     throw new Error(`claudraband could not resolve bundled Claude Code @anthropic-ai/claude-code@2.1.96 (${reason}). ` + `Install dependencies or set ${ENV_OVERRIDE} or ClaudrabandOptions.claudeExecutable.`);
   }
 }
+function resolveClaudeLaunchCommand(explicitPath) {
+  const executable = resolveClaudeExecutable(explicitPath);
+  if (executable.endsWith(".js")) {
+    return [process.execPath, executable];
+  }
+  return [executable];
+}
 var require2, ENV_OVERRIDE = "CLAUDRABAND_CLAUDE_PATH";
 var init_resolve = __esm(() => {
   require2 = createRequire2(import.meta.url);
@@ -5392,7 +5399,7 @@ class ClaudeWrapper {
   }
   buildCmd(...extra) {
     const cmd = [
-      resolveClaudeExecutable(this.cfg.claudeExecutable),
+      ...resolveClaudeLaunchCommand(this.cfg.claudeExecutable),
       "--model",
       this.cfg.model,
       ...this.cfg.claudeArgs

package/dist/claude/index.d.ts

@@ -2,7 +2,7 @@ export { ClaudeWrapper } from "./claude";
 export { sessionPath } from "./claude";
 export { parseClaudeArgs } from "./claude";
 export type { ClaudeConfig } from "./claude";
-export { resolveClaudeExecutable } from "./resolve";
+export { resolveClaudeExecutable, resolveClaudeLaunchCommand } from "./resolve";
 export { Tailer, parseLineEvents } from "./parser";
 export { hasPendingNativePrompt, hasPendingQuestion, parseNativePermissionPrompt, } from "./inspect";
 export { createTerminalHost, hasTmuxBinary, resolveTerminalBackend } from "../terminal";

package/dist/claude/resolve.d.ts

@@ -1,4 +1,5 @@
 export declare function resolveClaudeExecutable(explicitPath?: string): string;
+export declare function resolveClaudeLaunchCommand(explicitPath?: string): string[];
 export declare const __test: {
     ENV_OVERRIDE: string;
 };

package/dist/index.js

@@ -128,6 +128,9 @@ function hasSession(name) {
 function hasPane(id) {
   return spawnSync("bash", ["-lc", shellCommand("tmux", "display-message", "-p", "-t", id, "#{pane_id}")], { stdio: "pipe" }).status === 0;
 }
+function windowTarget(sessionName, windowName) {
+  return `${sessionName}:${windowName}`;
+}
 async function killSession(name) {
   if (!hasSession(name))
     return;
@@ -174,15 +177,12 @@ class Session {
       throw new Error("tmuxctl: command is required");
     }
     const format = "#{window_id}\t#{pane_id}";
-    const result = hasSession(name) ? await tmux("new-window", "-P", "-F", format, "-t", name, "-n", windowName, ...workingDir ? ["-c", workingDir] : [], ...command) : await tmux("new-session", "-d", "-P", "-F", format, "-s", name, "-n", windowName, "-x", String(width), "-y", String(height), ...workingDir ? ["-c", workingDir] : [], ...command);
+    const target = windowTarget(name, windowName);
+    const result = hasSession(name) ? await tmux("new-window", "-P", "-F", format, "-t", name, "-n", windowName, ...workingDir ? ["-c", workingDir] : [], ...command, ";", "set-option", "-q", "-t", name, "destroy-unattached", "off", ";", "set-option", "-q", "-t", name, "status", "off", ";", "resize-window", "-t", target, "-x", String(width), "-y", String(height)) : await tmux("new-session", "-d", "-P", "-F", format, "-s", name, "-n", windowName, "-x", String(width), "-y", String(height), ...workingDir ? ["-c", workingDir] : [], ...command, ";", "set-option", "-q", "-t", name, "destroy-unattached", "off", ";", "set-option", "-q", "-t", name, "status", "off", ";", "resize-window", "-t", target, "-x", String(width), "-y", String(height));
     const [windowId, paneId] = result.stdout.trim().split(/\s+/, 2);
     if (!windowId || !paneId) {
       throw new Error(`tmuxctl: failed to parse tmux target ids: ${result.stdout}`);
     }
-    try {
-      await tmux("set-option", "-t", name, "status", "off");
-    } catch {}
-    await tmux("resize-window", "-t", windowId, "-x", String(width), "-y", String(height));
     return new Session(name, command, windowId, paneId);
   }
   static async find(sessionName, windowName) {
@@ -5305,6 +5305,13 @@ function resolveClaudeExecutable(explicitPath) {
     throw new Error(`claudraband could not resolve bundled Claude Code @anthropic-ai/claude-code@2.1.96 (${reason}). ` + `Install dependencies or set ${ENV_OVERRIDE} or ClaudrabandOptions.claudeExecutable.`);
   }
 }
+function resolveClaudeLaunchCommand(explicitPath) {
+  const executable = resolveClaudeExecutable(explicitPath);
+  if (executable.endsWith(".js")) {
+    return [process.execPath, executable];
+  }
+  return [executable];
+}
 
 // ../claudraband-core/src/claude/claude.ts
 function sessionPath(cwd, sessionID) {
@@ -5404,7 +5411,7 @@ class ClaudeWrapper {
   }
   buildCmd(...extra) {
     const cmd = [
-      resolveClaudeExecutable(this.cfg.claudeExecutable),
+      ...resolveClaudeLaunchCommand(this.cfg.claudeExecutable),
       "--model",
       this.cfg.model,
       ...this.cfg.claudeArgs

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@halfwhey/claudraband",
-  "version": "0.5.0",
+  "version": "0.6.1",
   "description": "Control the official Claude Code CLI programmatically. Use as a library, a direct CLI, an ACP server, or a persistent session daemon.",
   "type": "module",
   "main": "./dist/index.js",