claude-code-rust 0.13.4 → 0.14.0

package/README.md

@@ -16,28 +16,39 @@ A native Rust terminal interface for Claude Code. Drop-in replacement for Anthro
 
 Claude Code Rust replaces the stock Claude Code terminal interface with a native Rust binary built on [Ratatui](https://ratatui.rs/). It connects to the same Claude API through a local Agent SDK bridge. Core Claude Code functionality - tool calls, file editing, terminal commands, and permissions - works unchanged.
 
-## Requisites
+## Prerequisite
 
-- Existing Claude Code authentication (`~/.claude/config.json`)
+- Install the Claude Code CLI. You do not need to authenticate before installing or starting `claude-rs`; sign in later with `/login` or `claude auth login` when needed.
 
 ## Install
 
-### npm (global, recommended)
+### Install script (recommended, v0.14.0+)
+
+The install script downloads a complete GitHub Release archive. It does not require Rust, Node.js, npm, or Bun on the user's machine.
+
+**macOS/Linux:**
 
 ```bash
-npm install -g claude-code-rust
+curl -fsSL https://raw.githubusercontent.com/srothgan/claude-code-rust/main/scripts/install/install.sh | sh
 ```
 
-The npm package installs a small launcher plus a platform-specific optional dependency containing the prebuilt Rust binary for your OS and architecture.
+**Windows PowerShell:**
 
-If `claude-rs` reports a missing platform package, check whether optional dependencies were omitted:
+```powershell
+powershell -NoProfile -ExecutionPolicy Bypass -Command "irm 'https://raw.githubusercontent.com/srothgan/claude-code-rust/main/scripts/install/install.ps1' | iex"
+```
+
+### npm (global)
+
+npm remains supported for users who prefer package-manager ownership of the global command:
 
 ```bash
-npm config get omit
 npm install -g claude-code-rust
 ```
 
-If `claude-rs` resolves to an older global shim, ensure your npm global bin directory comes first on `PATH` or remove the stale shim before retrying.
+This option requires Node.js 24 and npm. The npm package installs a small launcher plus a platform-specific optional dependency containing the prebuilt Rust binary, Agent SDK bridge, and bundled private Bun runtime for your OS and architecture. A separate Rust toolchain or Bun installation is not required.
+
+See the [installation guide](https://srothgan.github.io/claude-code-rust/installation.html) for release pinning, custom locations, switching install methods, and troubleshooting.
 
 ## Usage
 
@@ -66,7 +77,7 @@ Claude Code Rust addresses these with a native terminal UI that uses diffed, dir
 
 ## Documentation
 
-The manual covers installation from npm and source, help, slash commands, keyboard shortcuts, settings, diagnostics, architecture, and the changelog:
+The manual covers installation with scripts, npm, and source builds, plus help, slash commands, keyboard shortcuts, settings, diagnostics, architecture, and the changelog:
 
 - [Installation](https://srothgan.github.io/claude-code-rust/installation.html)
 - [Usage](https://srothgan.github.io/claude-code-rust/usage.html)

package/agent-sdk/dist/bridge/command_dispatch.js

@@ -1,8 +1,26 @@
+import { bridgeLogger, LOG_TARGETS } from "./logger.js";
 export async function dispatchCancelTurnCommand(command, deps) {
     const session = deps.sessionById(command.session_id);
     if (!session) {
         deps.slashError(command.session_id, `unknown session: ${command.session_id}`, deps.requestId);
         return;
     }
-    await session.query.interrupt();
+    const receipt = await session.query.interrupt();
+    const stillQueued = Array.isArray(receipt?.still_queued)
+        ? receipt.still_queued.filter((entry) => typeof entry === "string")
+        : [];
+    if (stillQueued.length > 0) {
+        bridgeLogger.info({
+            target: LOG_TARGETS.APP_SESSION,
+            eventName: "interrupt_receipt_still_queued",
+            message: "interrupt receipt reported queued async messages",
+            outcome: "success",
+            sessionId: command.session_id,
+            ...(deps.requestId ? { requestId: deps.requestId } : {}),
+            fields: {
+                still_queued_count: stillQueued.length,
+                still_queued: stillQueued,
+            },
+        });
+    }
 }

package/agent-sdk/dist/bridge/commands.js

@@ -307,6 +307,7 @@ export function parseCommandEnvelope(line) {
                     session_id: expectString(raw, "session_id", "reload_plugins"),
                 };
             case "mcp_status":
+            // Rust historically sends `get_mcp_snapshot`; normalize it to the bridge-internal command.
             case "get_mcp_snapshot":
                 return {
                     command: "mcp_status",
@@ -450,6 +451,9 @@ function parseQuestionAnnotation(value) {
     };
 }
 export function toPermissionMode(mode) {
+    if (mode === "manual") {
+        return "default";
+    }
     if (mode === "default" ||
         mode === "auto" ||
         mode === "acceptEdits" ||

package/agent-sdk/dist/bridge/message_handlers.js

@@ -3,7 +3,7 @@ import { toPermissionMode, buildModeState, refreshSupportedModesForSession } fro
 import { writeEvent, emitSessionUpdate, emitConnectEvent, emitSessionReplacedEvent, } from "./events.js";
 import { TOOL_RESULT_TYPES, isToolSearchToolName, isToolSearchToolResultType, unwrapToolUseResult, } from "./tooling.js";
 import { emitToolCall, emitToolCallUpdate, emitToolResultUpdate, finalizeOpenToolCalls, emitToolProgressUpdate, emitToolSummaryUpdate, ensureToolCallVisible, resolveTaskToolUseId, defersTaskNotificationCompletion, toolAcceptsTaskLifecycle, taskProgressText, taskUpdatedFields, } from "./tool_calls.js";
-import { applyTaskLifecycleState } from "./tasks.js";
+import { applyBackgroundTasksChanged, applyTaskLifecycleState } from "./tasks.js";
 import { linkTaskToolUse, unlinkTaskToolUse } from "./task_links.js";
 import { emitAuthRequired, classifyTurnErrorKind, emitFastModeUpdateIfChanged } from "./error_classification.js";
 import { mapAvailableAgentsFromNames, emitAvailableAgentsIfChanged, refreshAvailableAgents } from "./agents.js";
@@ -39,6 +39,7 @@ function sdkCorrelationMetadata(msg) {
         requestId: typeof msg.request_id === "string" ? msg.request_id : undefined,
         subagentType: typeof msg.subagent_type === "string" ? msg.subagent_type : undefined,
         taskDescription: typeof msg.task_description === "string" ? msg.task_description : undefined,
+        parentAgentId: typeof msg.parent_agent_id === "string" ? msg.parent_agent_id : undefined,
     };
 }
 function sdkTaskMetadata(msg) {
@@ -53,12 +54,14 @@ function sdkTaskMetadata(msg) {
         ...(metadata.requestId ? { request_id: metadata.requestId } : {}),
         ...(metadata.subagentType ? { subagent_type: metadata.subagentType } : {}),
         ...(metadata.taskDescription ? { task_description: metadata.taskDescription } : {}),
+        ...(metadata.parentAgentId ? { parent_agent_id: metadata.parentAgentId } : {}),
         ...(taskType ? { task_type: taskType } : {}),
         ...(workflowName ? { workflow_name: workflowName } : {}),
         ...(prompt ? { prompt } : {}),
         ...(outputFile ? { output_file: outputFile } : {}),
         ...(summary ? { summary } : {}),
         ...(status ? { terminal_status: status } : {}),
+        ...(typeof msg.blocked === "boolean" ? { blocked: msg.blocked } : {}),
     };
     return Object.keys(taskMetadata).length > 0 ? taskMetadata : undefined;
 }
@@ -822,6 +825,13 @@ function terminalReasonFromValue(value) {
         case "hook_stopped":
         case "tool_deferred":
         case "max_turns":
+        case "background_requested":
+        case "api_error":
+        case "malformed_tool_use_exhausted":
+        case "budget_exhausted":
+        case "structured_output_retry_exhausted":
+        case "tool_deferred_unavailable":
+        case "turn_setup_failed":
         case "completed":
             return value;
         default:
@@ -848,6 +858,10 @@ export function handleSdkMessage(session, message) {
             updateAvailableCommands(session, "commands_changed", mapSdkSlashCommands(msg.commands));
             return;
         }
+        if (subtype === "background_tasks_changed") {
+            applyBackgroundTasksChanged(session, msg);
+            return;
+        }
         if (subtype === "notification") {
             const text = typeof msg.text === "string" ? msg.text : "";
             emitSystemNoticeUpdate(session, notificationSeverity(msg.priority), text);

package/agent-sdk/dist/bridge/session_lifecycle.js

@@ -542,6 +542,8 @@ function permissionModeFromSettingsValue(rawMode) {
         return undefined;
     }
     switch (rawMode) {
+        case "manual":
+            return "default";
         case "default":
         case "auto":
         case "acceptEdits":

package/agent-sdk/dist/bridge/tasks.js

@@ -9,6 +9,7 @@ const TASK_TOOL_NAMES = new Set([
     "TaskOutput",
     "TaskStop",
 ]);
+const BACKGROUND_TASK_METADATA_KEY = "sdk_background_task";
 export function isTaskToolName(name) {
     return TASK_TOOL_NAMES.has(name);
 }
@@ -806,6 +807,8 @@ function lifecycleMetadata(msg) {
         "summary",
         "end_time",
         "total_paused_ms",
+        "blocked",
+        "parent_agent_id",
     ]) {
         copyValue(msg, key);
         copyValue(patch, key);
@@ -857,6 +860,43 @@ export function applyTaskLifecycleState(session, subtype, msg) {
         }),
     ]);
 }
+export function applyBackgroundTasksChanged(session, msg) {
+    const rawTasks = Array.isArray(msg.tasks) ? msg.tasks : [];
+    const nextTasks = rawTasks
+        .map((entry) => {
+        const task = asRecordOrNull(entry);
+        const taskId = nonEmptyString(task?.task_id);
+        if (!task || !taskId) {
+            return undefined;
+        }
+        const taskType = nonEmptyString(task.task_type);
+        const description = nonEmptyString(task.description);
+        return {
+            task_id: taskId,
+            subject: description ?? taskType ?? taskId,
+            description,
+            status: "in_progress",
+            blocks: [],
+            blocked_by: [],
+            metadata: {
+                [BACKGROUND_TASK_METADATA_KEY]: true,
+                ...(taskType ? { task_type: taskType } : {}),
+            },
+        };
+    })
+        .filter((task) => Boolean(task));
+    const nextIds = new Set(nextTasks.map((task) => task.task_id));
+    const removedTaskIds = session.taskOrder.filter((taskId) => {
+        if (nextIds.has(taskId)) {
+            return false;
+        }
+        const metadata = asRecordOrNull(session.tasksById.get(taskId)?.metadata);
+        return metadata?.[BACKGROUND_TASK_METADATA_KEY] === true;
+    });
+    const tasks = nextTasks.map((task) => upsertTask(session, task));
+    const removed = removeTasks(session, removedTaskIds);
+    emitTaskStateUpdate(session, "background_tasks", tasks, removed, true);
+}
 export function currentTaskSnapshot(session) {
     return orderedTasks(session);
 }

package/agent-sdk/dist/bridge/tool_calls.js

@@ -423,6 +423,12 @@ function buildTaskMetadata(patch) {
     if (typeof patch.status === "string" && ["completed", "failed", "killed"].includes(patch.status)) {
         taskMetadata.terminal_status = patch.status;
     }
+    if (typeof patch.blocked === "boolean") {
+        taskMetadata.blocked = patch.blocked;
+    }
+    if (typeof patch.parent_agent_id === "string" && patch.parent_agent_id.length > 0) {
+        taskMetadata.parent_agent_id = patch.parent_agent_id;
+    }
     return Object.keys(taskMetadata).length > 0 ? taskMetadata : undefined;
 }
 export function taskUpdatedFields(msg) {

package/agent-sdk/dist/bridge/tooling.js

@@ -261,7 +261,6 @@ export function toolTitle(name, input, context = {}) {
         return label ? `${ARTIFACT_TOOL_NAME}: ${label}` : ARTIFACT_TOOL_NAME;
     }
     if (name === SHOW_ONBOARDING_ROLE_PICKER_TOOL_NAME) {
-        // TODO: The TUI accepts this SDK tool call but does not implement an onboarding role flow yet.
         return SHOW_ONBOARDING_ROLE_PICKER_TOOL_NAME;
     }
     if (name === "EnterWorktree") {

package/agent-sdk/dist/bridge.js

@@ -130,7 +130,7 @@ export function emitAgentConfigOptionUpdate(sessionId, agent) {
         value: agent,
     });
 }
-const EXPECTED_AGENT_SDK_VERSION = "0.3.198";
+const EXPECTED_AGENT_SDK_VERSION = "0.3.207";
 const require = createRequire(import.meta.url);
 export function resolveInstalledAgentSdkVersion() {
     try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-code-rust",
-  "version": "0.13.4",
+  "version": "0.14.0",
   "description": "Claude Code Rust - native Rust terminal interface for Claude Code",
   "keywords": [
     "cli",
@@ -33,15 +33,15 @@
     "LICENSE"
   ],
   "dependencies": {
-    "@anthropic-ai/claude-agent-sdk": "0.3.198"
+    "@anthropic-ai/claude-agent-sdk": "0.3.207"
   },
   "optionalDependencies": {
-    "@srothgan/claude-code-rust-darwin-arm64": "0.13.4",
-    "@srothgan/claude-code-rust-darwin-x64": "0.13.4",
-    "@srothgan/claude-code-rust-linux-x64-gnu": "0.13.4",
-    "@srothgan/claude-code-rust-linux-arm64-gnu": "0.13.4",
-    "@srothgan/claude-code-rust-win32-x64-msvc": "0.13.4",
-    "@srothgan/claude-code-rust-win32-arm64-msvc": "0.13.4"
+    "@srothgan/claude-code-rust-darwin-arm64": "0.14.0",
+    "@srothgan/claude-code-rust-darwin-x64": "0.14.0",
+    "@srothgan/claude-code-rust-linux-x64-gnu": "0.14.0",
+    "@srothgan/claude-code-rust-linux-arm64-gnu": "0.14.0",
+    "@srothgan/claude-code-rust-win32-x64-msvc": "0.14.0",
+    "@srothgan/claude-code-rust-win32-arm64-msvc": "0.14.0"
   },
   "engines": {
     "node": ">=24"