codekanban 0.37.0 → 0.38.0

package/Dockerfile

@@ -4,7 +4,7 @@ FROM node:22.12-alpine AS frontend-builder
 WORKDIR /app/ui
 
 # Install pnpm using npm
-RUN npm install -g pnpm@latest
+RUN npm install -g pnpm@9.15.9
 
 # Copy frontend package files
 COPY ui/package.json ui/pnpm-lock.yaml ./

package/README.md

@@ -78,7 +78,7 @@ After installing the CLI and skills, restart Codex so the new skill is discovere
 ### Requirements
 - **Node.js**: v20.19.0+ or v22.12.0+
 - **Go**: 1.24.6+
-- **Package Manager**: pnpm (recommended)
+- **Package Manager**: pnpm 9.15.9
 
 ### Install Dependencies
 

package/README.zh-CN.md

@@ -55,7 +55,7 @@ npm install -g codekanban@latest
 ### 环境要求
 - **Node.js**: v20.19.0+ 或 v22.12.0+
 - **Go**: 1.24.6+
-- **包管理器**: pnpm（推荐）
+- **包管理器**: pnpm 9.15.9
 
 ### 安装依赖
 

package/package.json

@@ -1,16 +1,16 @@
 {
   "name": "codekanban",
-  "version": "0.37.0",
+  "version": "0.38.0",
   "description": "An auxiliary programming tool for the AI era, helping you speed up 10x.",
   "bin": {
     "codekanban": "npm-bin/codekanban.js"
   },
   "optionalDependencies": {
-    "@codekanban/win32-x64": "0.37.0",
-    "@codekanban/darwin-x64": "0.37.0",
-    "@codekanban/darwin-arm64": "0.37.0",
-    "@codekanban/linux-x64": "0.37.0",
-    "@codekanban/linux-arm64": "0.37.0"
+    "@codekanban/win32-x64": "0.38.0",
+    "@codekanban/darwin-x64": "0.38.0",
+    "@codekanban/darwin-arm64": "0.38.0",
+    "@codekanban/linux-x64": "0.38.0",
+    "@codekanban/linux-arm64": "0.38.0"
   },
   "keywords": [
     "ai",

package/packages/codekanban-cli/src/core.js

@@ -20,6 +20,7 @@ const VALUE_FLAGS = new Set([
   '--prompt',
   '--text',
   '--agent',
+  '--claude-runtime',
   '--model',
   '--profile',
   '--sandbox',

package/packages/codekanban-cli/src/runtime.js

@@ -12,6 +12,14 @@ function readFlagValue(argv, index, flag) {
   return value;
 }
 
+function readRawFlagValue(argv, index, flag) {
+  const value = argv[index + 1];
+  if (value == null) {
+    throw new Error(`${flag} requires a value`);
+  }
+  return value;
+}
+
 function parseIntegerFlag(value, fieldName) {
   if (value == null || value === '') {
     return undefined;
@@ -83,6 +91,10 @@ function parseCliArgs(argv) {
         flags.agent = readFlagValue(argv, index, token);
         index += 1;
         break;
+      case '--claude-runtime':
+        flags.claudeRuntime = readFlagValue(argv, index, token);
+        index += 1;
+        break;
       case '--model':
         flags.model = readFlagValue(argv, index, token);
         index += 1;
@@ -108,7 +120,7 @@ function parseCliArgs(argv) {
         index += 1;
         break;
       case '--extra-arg':
-        flags.extraArgs.push(readFlagValue(argv, index, token));
+        flags.extraArgs.push(readRawFlagValue(argv, index, token));
         index += 1;
         break;
       case '--title':
@@ -282,6 +294,7 @@ Common options:
   --project-id <id>     Project identifier
   --path <path>         Local project path
   --session-id <id>     Session identifier
+  --claude-runtime <rt> Claude launcher for workflow terminal mode: claude or ccr
   --help                Show this help text
 
 Examples:
@@ -620,6 +633,7 @@ export async function runCli(argv, options = {}) {
     if (scope === 'workflow' && action === 'command') {
       const result = buildAgentLaunchSpec({
         agent: flags.agent,
+        claudeRuntime: flags.claudeRuntime,
         profile: flags.profile,
         permissions: buildPermissions(flags),
         extraArgs: flags.extraArgs,
@@ -652,6 +666,7 @@ export async function runCli(argv, options = {}) {
         worktreeId: flags.worktreeId,
         prompt: flags.prompt,
         agent: flags.agent,
+        claudeRuntime: flags.claudeRuntime,
         profile: flags.profile,
         permissions: buildPermissions(flags),
         extraArgs: flags.extraArgs,

package/packages/node-sdk/src/client.js

@@ -1003,6 +1003,7 @@ export class CodeKanbanClient {
         body: {
           worktreeId: ensureString(worktree?.id, "worktreeId"),
           agent,
+          claudeRuntime: ensureOptionalString(input.claudeRuntime) || "claude",
           model:
             ensureOptionalString(input.model) || defaultWebSessionModel(agent),
           reasoningEffort:
@@ -1367,6 +1368,48 @@ export class CodeKanbanClient {
     );
   }
 
+  async getWebSessionGoal({ sessionId }) {
+    return await this.withWebSessionCommandChannel((channel) =>
+      channel.getGoal(sessionId),
+    );
+  }
+
+  async setWebSessionGoal({ sessionId, objective, status }) {
+    return await this.withWebSessionCommandChannel((channel) =>
+      channel.setGoal(sessionId, {
+        objective,
+        status: ensureOptionalString(status),
+      }),
+    );
+  }
+
+  async bootstrapWebSessionGoal({ sessionId, objective, status }) {
+    return await this.withWebSessionCommandChannel((channel) =>
+      channel.bootstrapGoal(sessionId, {
+        objective,
+        status: ensureOptionalString(status),
+      }),
+    );
+  }
+
+  async pauseWebSessionGoal({ sessionId }) {
+    return await this.withWebSessionCommandChannel((channel) =>
+      channel.pauseGoal(sessionId),
+    );
+  }
+
+  async resumeWebSessionGoal({ sessionId }) {
+    return await this.withWebSessionCommandChannel((channel) =>
+      channel.resumeGoal(sessionId),
+    );
+  }
+
+  async clearWebSessionGoal({ sessionId }) {
+    return await this.withWebSessionCommandChannel((channel) =>
+      channel.clearGoal(sessionId),
+    );
+  }
+
   async answerPendingUserInput({
     projectId,
     projectName,
@@ -1878,6 +1921,7 @@ export class CodeKanbanClient {
       worktree,
       terminalSession: terminal,
       agent: launch.agent,
+      claudeRuntime: launch.claudeRuntime,
       profile: launch.profile,
       command: launch.command,
       prompt: launch.prompt,

package/packages/node-sdk/src/command-builder.js

@@ -5,6 +5,7 @@ export const SANDBOX_MODES = ['read-only', 'workspace-write', 'danger-full-acces
 export const APPROVAL_POLICIES = ['untrusted', 'on-request', 'never'];
 export const WORKFLOW_PROFILES = ['plan', 'standard', 'yolo'];
 export const AGENTS = ['codex', 'claude'];
+export const CLAUDE_RUNTIMES = ['claude', 'ccr'];
 
 const KNOWN_STRUCTURED_FLAGS = new Set([
   '-s',
@@ -60,15 +61,18 @@ export function buildAgentLaunchSpec(options = {}) {
   const extraArgs = ensureArrayOfStrings(options.extraArgs, 'extraArgs');
 
   if (agent === 'claude') {
+    const claudeRuntime =
+      validateEnum(options.claudeRuntime || 'claude', CLAUDE_RUNTIMES, 'claudeRuntime') || 'claude';
     if (profile !== 'standard') {
       throw new CodeKanbanValidationError('claude only supports the standard profile in v1');
     }
     if (options.permissions) {
       throw new CodeKanbanValidationError('structured permissions are only supported for codex in v1');
     }
-    const argv = ['claude', ...extraArgs];
+    const argv = claudeRuntime === 'ccr' ? ['ccr', 'code', ...extraArgs] : ['claude', ...extraArgs];
     return {
       agent,
+      claudeRuntime,
       profile,
       argv,
       command: toCommandString(argv),

package/packages/node-sdk/src/web-session-command-channel.js

@@ -119,6 +119,7 @@ export class WebSessionCommandChannel {
         pid: ensureString(input.projectId, "projectId"),
         wid: ensureOptionalString(input.worktreeId),
         ag: ensureString(input.agent, "agent"),
+        cr: ensureOptionalString(input.claudeRuntime),
         md: ensureOptionalString(input.model),
         re: ensureOptionalString(input.reasoningEffort),
         wm: ensureOptionalString(input.workflowMode),
@@ -230,6 +231,16 @@ export class WebSessionCommandChannel {
     });
   }
 
+  async updateClaudeRuntime(sessionId, input = {}) {
+    return await this._executeCommand({
+      operation: "set_cr",
+      sessionId,
+      payload: {
+        cr: ensureString(input.claudeRuntime, "claudeRuntime"),
+      },
+    });
+  }
+
   async updateReasoningEffort(sessionId, input = {}) {
     return await this._executeCommand({
       operation: "set_re",
@@ -250,6 +261,56 @@ export class WebSessionCommandChannel {
     });
   }
 
+  async getGoal(sessionId) {
+    return await this._executeCommand({
+      operation: "goal_get",
+      sessionId,
+    });
+  }
+
+  async setGoal(sessionId, input = {}) {
+    return await this._executeCommand({
+      operation: "goal_set",
+      sessionId,
+      payload: {
+        obj: ensureString(input.objective, "objective"),
+        st: ensureOptionalString(input.status),
+      },
+    });
+  }
+
+  async bootstrapGoal(sessionId, input = {}) {
+    return await this._executeCommand({
+      operation: "goal_bootstrap",
+      sessionId,
+      payload: {
+        obj: ensureString(input.objective, "objective"),
+        st: ensureOptionalString(input.status),
+      },
+    });
+  }
+
+  async pauseGoal(sessionId) {
+    return await this._executeCommand({
+      operation: "goal_pause",
+      sessionId,
+    });
+  }
+
+  async resumeGoal(sessionId) {
+    return await this._executeCommand({
+      operation: "goal_resume",
+      sessionId,
+    });
+  }
+
+  async clearGoal(sessionId) {
+    return await this._executeCommand({
+      operation: "goal_clear",
+      sessionId,
+    });
+  }
+
   async updatePermissionLevel(sessionId, input = {}) {
     return await this._executeCommand({
       operation: "set_pl",

package/packages/node-sdk/src/web-session-shared.js

@@ -89,6 +89,30 @@ function normalizeContextEstimate(value, usageFallback) {
   };
 }
 
+function normalizeGoal(value) {
+  if (!value || typeof value !== "object") {
+    return null;
+  }
+  const objective = trimmedString(value?.obj ?? value?.objective);
+  const threadId = trimmedString(value?.tid ?? value?.threadId);
+  const status = trimmedString(value?.st ?? value?.status);
+  if (!objective || !threadId || !status) {
+    return null;
+  }
+  return {
+    threadId,
+    objective,
+    status,
+    tokenBudget: nullableNumberValue(value?.tb ?? value?.tokenBudget),
+    tokensUsed: numberValue(value?.tu ?? value?.tokensUsed, 0),
+    timeUsedSeconds: numberValue(value?.tsu ?? value?.timeUsedSeconds, 0),
+    createdAt:
+      isoFromUnixMilli(value?.ca ?? value?.createdAt) || new Date().toISOString(),
+    updatedAt:
+      isoFromUnixMilli(value?.ua ?? value?.updatedAt) || new Date().toISOString(),
+  };
+}
+
 function normalizeHistoryAttachment(value) {
   return {
     id: trimmedString(value?.id),
@@ -264,6 +288,7 @@ export function normalizeWebSessionSummaryFromWire(value) {
     worktreeId: trimmedString(value?.wid) || null,
     orderIndex: numberValue(value?.oi, 0),
     agent: trimmedString(value?.ag) || "codex",
+    claudeRuntime: trimmedString(value?.cr) === "ccr" ? "ccr" : "claude",
     title: trimmedString(value?.ttl),
     model: trimmedString(value?.md),
     reasoningEffort: trimmedString(value?.re) || "default",
@@ -303,6 +328,7 @@ export function normalizeWebSessionSummaryFromWire(value) {
     lastContextCompactionAt: isoFromUnixMilli(value?.lcca),
     contextWindowTokens: nullableNumberValue(value?.cwt),
     contextWindowSource: trimmedString(value?.cws) || "unavailable",
+    goal: normalizeGoal(value?.goal),
   };
 }