About

Claude Code Rust is a native Rust terminal interface for Claude Code. It replaces the stock Node.js and React Ink terminal UI with a Ratatui-based binary while keeping Claude Code functionality routed through Anthropic’s Agent SDK.

The goal is a faster, lower-memory terminal experience with reliable scrollback, direct terminal rendering, native input handling, and a project-local configuration surface.

Project Status

The project is pre-1.0. The current release line is 0.12.x, and the crate version is tracked in the root Cargo.toml.

The project is useful today, but the runtime still depends on the upstream Claude Agent SDK bridge. Startup readiness, authentication behavior, billing, model availability, and service limits are controlled by Anthropic.

Relationship To Anthropic

This project is not affiliated with, endorsed by, or supported by Anthropic. It is a third-party terminal UI that talks to the official Agent SDK through a local TypeScript bridge. It is not a fork, copy, or port of Anthropic’s Claude Code source.

For official Claude documentation, use the Claude documentation:

• Claude Docs
• Claude Code Agent SDK overview

Billing Note

Because Claude Code Rust uses the Agent SDK, usage should be treated as Agent SDK usage. Anthropic’s support article says that starting June 15, 2026, Agent SDK and claude -p usage on eligible Claude plans move to a separate monthly Agent SDK credit instead of normal interactive Claude plan usage limits.

Check Anthropic’s current support article before relying on billing assumptions:

• Use the Claude Agent SDK with your Claude plan

Installation

Prerequisites

Claude Code Rust needs:

• Node.js 18 or newer for the Agent SDK bridge runtime.
• Existing Claude Code authentication, currently read from ~/.claude/config.json.
• Rust 1.88.0 or newer only when building from source.

Install From npm

The recommended install path is the published npm package:

npm install -g claude-code-rust
claude-rs --version
claude-rs

The package installs a claude-rs launcher. During postinstall, it downloads the matching prebuilt Rust binary from GitHub Releases into the package vendor/ directory.

Supported published binary targets:

The installer also tries to copy the current Node.js executable next to the Rust binary as claude-rs-bridge-node or claude-rs-bridge-node.exe. If that copy fails, the Rust binary falls back to node on PATH.

Build From Source

Use this path when developing the project or testing a fork without installing a global claude-rs command:

git clone https://github.com/srothgan/claude-code-rust.git
cd claude-code-rust
npm ci --prefix agent-sdk
npm run build --prefix agent-sdk
cargo run 

Install A Source Or Fork Build Globally

Use this path when you want a fully local build that can be launched as claude-rs from any directory. It installs through npm’s global package location under the package name claude-code-rust, the same package name used by the published npm install. That means a later npm install -g claude-code-rust replaces the same global package and shim instead of competing with a separate cargo install binary on PATH.

Do not use cargo install --path . for the global command if you want this behavior. cargo install writes to Cargo’s bin directory and can create a separate claude-rs earlier or later on PATH.

Windows x64

git clone https://github.com/<you>/claude-code-rust.git
cd claude-code-rust

npm ci --prefix agent-sdk
npm run build --prefix agent-sdk

cargo build --release --locked --target x86_64-pc-windows-msvc --bin claude-rs

$target = "x86_64-pc-windows-msvc"
New-Item -ItemType Directory -Force "vendor\$target" | Out-Null
Copy-Item "target\$target\release\claude-rs.exe" "vendor\$target\claude-rs.exe" -Force
Copy-Item (Get-Command node).Source "vendor\$target\claude-rs-bridge-node.exe" -Force

npm install -g . --ignore-scripts
claude-rs --version

Linux x64

git clone https://github.com/<you>/claude-code-rust.git
cd claude-code-rust

npm ci --prefix agent-sdk
npm run build --prefix agent-sdk

target=x86_64-unknown-linux-gnu
cargo build --release --locked --target "$target" --bin claude-rs

mkdir -p "vendor/$target"
cp "target/$target/release/claude-rs" "vendor/$target/claude-rs"
chmod +x "vendor/$target/claude-rs"
cp "$(command -v node)" "vendor/$target/claude-rs-bridge-node"
chmod +x "vendor/$target/claude-rs-bridge-node"

npm install -g . --ignore-scripts
claude-rs --version

macOS

For Apple Silicon:

target=aarch64-apple-darwin

For Intel macOS:

target=x86_64-apple-darwin

Then run:

git clone https://github.com/<you>/claude-code-rust.git
cd claude-code-rust

npm ci --prefix agent-sdk
npm run build --prefix agent-sdk

cargo build --release --locked --target "$target" --bin claude-rs

mkdir -p "vendor/$target"
cp "target/$target/release/claude-rs" "vendor/$target/claude-rs"
chmod +x "vendor/$target/claude-rs"
cp "$(command -v node)" "vendor/$target/claude-rs-bridge-node"
chmod +x "vendor/$target/claude-rs-bridge-node"

npm install -g . --ignore-scripts
claude-rs --version

The local global install relies on the same launcher shape as the published npm package:

• bin/claude-rs.js is installed as the global claude-rs shim.
• vendor/<target>/claude-rs or vendor/<target>/claude-rs.exe is the Rust binary the shim launches.
• agent-sdk/dist/bridge.js is included from the source checkout after npm run build --prefix agent-sdk.
• claude-rs-bridge-node is a copied Node runtime, matching the published installer behavior. If that file is missing, the Rust binary falls back to node on PATH.

To go back to the published package later:

npm install -g claude-code-rust

That overwrites the same global npm package and command shim.

Manual Bridge Overrides

If you need to run a manually built binary outside the npm package layout, pass the bridge explicitly:

claude-rs --bridge-script /path/to/claude-code-rust/agent-sdk/dist/bridge.js

You can also set:

CLAUDE_RS_AGENT_BRIDGE=/path/to/agent-sdk/dist/bridge.js

If the bundled or system Node runtime needs an explicit override, set:

CLAUDE_RS_AGENT_BRIDGE_NODE=/path/to/node

Troubleshooting

If claude-rs does not launch after npm install:

• Confirm the npm global bin directory is first on PATH.
• Remove stale global shims from older installs.
• Reinstall with npm install -g claude-code-rust.
• Confirm your platform is one of the published targets above.
• Confirm Node.js 18 or newer is available.
• Confirm Claude Code authentication exists at ~/.claude/config.json.
• If running from source, confirm agent-sdk/dist/bridge.js exists.

When reporting install problems, include the install method, OS, terminal, node --version, claude-rs --version, the command you ran, and the exact error output.

Usage

Start a new session in the current directory:

claude-rs

Start in a specific working directory:

claude-rs -C path/to/project

Resume a previous session:

claude-rs resume

Resume by session id:

claude-rs resume <session_id>

The app prints a resume hint on clean exit when the active session has an id.

CLI Options

The installed claude-rs --help command exposes these options:

See Diagnostics before enabling verbose logs or perf telemetry.

Core UI

The main screen is a terminal-owned chat view. The app renders messages, tool calls, diffs, permissions, questions, autocomplete, and status directly through Crossterm and Ratatui.

Common surfaces:

• Chat input for prompts and multiline text.
• File, slash-command, and subagent autocomplete.
• Inline permission prompts for tool decisions.
• Inline questions for agent-requested choices or text.
• Fullscreen settings, status, usage, MCP, plugins, and help tabs.
• Session picker when running claude-rs resume without a session id.

Use /help for the fullscreen help tab, /config for settings, and /docs <topic> for live in-chat help generated from the running app state.

More Usage Topics

• Slash Commands
• Keyboard Shortcuts
• Settings
• Diagnostics
• Help

Slash Commands

Claude Code Rust has app-owned slash commands and can also show slash commands advertised by the active Agent SDK session. App-owned commands are available from the Rust TUI itself; SDK-advertised commands depend on the current session and what the bridge reports.

Use /docs commands in the app to render the live merged command list into chat. That is the source to use when you want to know exactly which app-owned and SDK-advertised commands are available in the current session.

App-Owned Commands

SDK-Advertised Commands

The active SDK session can advertise additional slash commands. These are not documented as a fixed table here because they can change with SDK behavior, session capabilities, account state, and future upstream changes.

Use:

/docs commands

to inspect the current session’s full command list. The output includes app-owned commands and SDK-advertised commands, with descriptions when the SDK provides them.

Project-Local Commands

/1m-context and /opus-version persist folder-local settings under ./.claude/settings.local.json. The current session is not restarted automatically, so run /new-session after changing either setting.

/1m-context disable writes the environment setting used to disable the 1M context window for future sessions in that folder. enable clears that override.

/opus-version <version> pins the folder-local Opus alias. default clears the pin.

Keyboard Shortcuts

Keyboard shortcuts are context-sensitive. Use /docs shortcuts in the app to show the live shortcuts for the current state.

Global

When the app is blocked before a usable session is available, Ctrl+C quits.

Chat Input

Readline-style bindings are also supported:

Undo And Redo

On Unix except macOS, Ctrl+Z is reserved for process suspend.

Autocomplete

Inline Permissions

Letter shortcuts such as Ctrl+A, Ctrl+Y, or Ctrl+N are not permission shortcuts.

Inline Questions

Settings

Claude Code Rust has a fullscreen settings surface with multiple tabs. These slash commands open that surface directly:

The settings surface is session-aware. Some tabs need an active bridge session before they can show live SDK-backed state.

Usage

Open the settings surface with any command in the table above. Each command opens the same fullscreen surface but targets a different starting tab.

The tab order is:

Settings -> Plugins -> Status -> Usage -> MCP -> Help

Use Tab to move to the next tab and Shift+Tab to move to the previous tab. The active tab can also have its own navigation and action keys. For example, the Settings tab edits persisted settings, the Plugins tab navigates plugin lists and overlays, the MCP tab opens server actions and authorization flows, and the Usage and Status tabs refresh live session-backed data.

The surface is not only for editing JSON settings. It is the shared fullscreen control area for settings, plugins, MCP, account/session status, usage, and in-app help.

Help

Use /help when you want fullscreen help inside the same tabbed surface. The Help tab has three sections:

Use Left and Right inside the Help tab to switch sections. Use Up and Down to move through rows in the active section.

The Help tab is live UI, not a static manual page. Its Shortcuts section changes with focus and state, and its Commands and Subagents sections depend on what the active SDK session advertises.

Settings Files

Settings are loaded from Claude-compatible JSON files. The app can edit supported settings and display unsupported settings that exist for compatibility or future work.

Malformed JSON files are backed up with a timestamped .bak extension and replaced in memory with an empty object so the app can keep running.

Supported Settings

Currently Unsupported Settings

These settings are represented in the settings UI but are not currently supported by the app runtime:

MCP

The MCP tab shows live session-backed MCP state. Use /mcp to inspect servers, refresh status, complete authorization, reconnect servers, and handle SDK-provided MCP prompts when available.

If no session is active, the tab asks you to open or resume a session first. If the active session reports no MCP servers, the tab shows an empty state rather than editing raw config files.

Plugins

The Plugins tab is available through /plugins. It shows installed plugins, marketplace plugins, and configured marketplaces.

Supported actions include enabling, disabling, updating, uninstalling, and installing plugins into user, project, or local scopes when those actions are available for the selected plugin.

After plugin changes, the app requests a session runtime plugin reload when an active session is available.

Project-Local Overrides

Two slash commands write project-local environment overrides into ./.claude/settings.local.json:

/1m-context <enable|disable|status>
/opus-version <4.5|4.6|4.7|default|status>

These settings apply to future sessions. Run /new-session after changing them.

Diagnostics

Diagnostics are off by default. Enable them only when debugging or preparing a useful issue report because verbose logs can grow quickly.

Logging

Enable runtime diagnostics with a named preset:

claude-rs --enable-logs --diagnostics-preset session
claude-rs --enable-logs --diagnostics-preset render

Available presets:

Use an explicit log path when you want the file somewhere predictable:

claude-rs --enable-logs --diagnostics-preset bridge --log-file claude-rs.log

Use an explicit tracing filter for targeted debugging:

claude-rs --log-filter "info,app.render=trace,bridge.protocol=debug"

--log-filter overrides --diagnostics-preset. If --log-file is omitted but logging is enabled through --enable-logs, --diagnostics-preset, --log-filter, --log-append, or RUST_LOG, the app writes to the default diagnostics path.

The default path is under the platform local data directory:

• Windows: %LOCALAPPDATA%\claude-code-rust\logs\claude-rs.log
• Linux: usually $XDG_DATA_HOME/claude-code-rust/logs/claude-rs.log or ~/.local/share/claude-code-rust/logs/claude-rs.log
• macOS: the platform data directory reported by the dirs crate, under claude-code-rust/logs/claude-rs.log

Logs rotate at 10 MB and keep up to five rotated files.

Bridge Diagnostics

When runtime logging is active, bridge diagnostics are enabled and bridge stderr is captured into the structured log. This is useful for Agent SDK startup, authentication, MCP, permission, and protocol issues.

The bridge script can be overridden with:

claude-rs --bridge-script /path/to/agent-sdk/dist/bridge.js

or:

CLAUDE_RS_AGENT_BRIDGE=/path/to/agent-sdk/dist/bridge.js

The bridge Node runtime can be overridden with:

CLAUDE_RS_AGENT_BRIDGE_NODE=/path/to/node

Perf Telemetry

Perf telemetry is a separate JSON-lines sidecar intended for high-frequency render and layout samples. It requires a binary built with the perf feature.

From source:

cargo run --features perf -- --enable-perf
cargo run --features perf -- --perf-log claude-rs-perf.log

For an already-built perf-enabled binary:

claude-rs --enable-perf
claude-rs --perf-log claude-rs-perf.log

If the binary was not built with --features perf, perf flags are rejected at startup.

Useful Issue Reports

Include:

• claude-rs --version
• OS and terminal.
• Install method: npm package, source build, fork build, or manual binary.
• The exact command used to launch the app.
• Whether a custom bridge script or Node runtime was used.
• A short reproduction.
• Relevant log snippets, not full secrets or private conversation content.

Help

Claude Code Rust has two built-in help paths:

/help
/docs <topic>

/help opens the fullscreen Help tab. Use it when you want navigable in-app help without adding a message to the chat transcript.

/docs renders live help into the chat. Use it when you want the current commands, shortcuts, modes, models, or subagents copied into the conversation as reference material.

Fullscreen Help

The fullscreen Help tab has three sections:

Use Left and Right to switch Help sections. Use Up and Down to move through the visible rows in the active section.

The Shortcuts section is state-sensitive. It changes depending on whether focus is in chat input, autocomplete, an inline permission prompt, an inline question, or a blocked state such as connecting or command-pending.

The Commands and Subagents sections are also session-sensitive. While the app is connecting, they show loading rows. If the active session does not advertise SDK commands or subagents, the Help tab shows an empty-state row instead of inventing unavailable entries.

In-Chat Docs

/docs covers two topics that are not sections in the fullscreen Help tab: mode and models. Those topics are based on the active session’s advertised modes and models.

The /docs output is based on the running app state. It can differ from this manual when the active session advertises different models, modes, commands, or agents.

Architecture

Claude Code Rust is split into a native Rust terminal app and a TypeScript Agent SDK bridge.

Runtime Shape

The Rust binary owns the terminal UI and process lifecycle. It parses CLI options with Clap, starts a Tokio runtime, and runs the app inside a LocalSet because parts of the terminal and child-process runtime are not Send.

The app then starts or resumes a bridge session and renders the chat view directly in the terminal.

Rust Terminal App

Important Rust areas:

The current runtime uses inline terminal-owned rendering rather than an older fullscreen-only model. Fullscreen views are still used for config, help, status, usage, MCP, and plugin surfaces.

Agent SDK Bridge

The Rust process spawns a local Node runtime that runs:

agent-sdk/dist/bridge.js

The TypeScript bridge wraps @anthropic-ai/claude-agent-sdk. Rust and TypeScript communicate over stdin/stdout using newline-delimited JSON command and event envelopes.

Rust sends commands such as session creation, session resume, prompt submission, permission responses, MCP actions, and runtime refresh requests. The bridge sends events such as assistant messages, tool updates, permission requests, question requests, available commands, modes, models, usage, and errors.

Packaging

The npm package exposes a claude-rs JavaScript launcher. That launcher finds the platform-specific Rust binary downloaded during npm postinstall and forwards CLI arguments to it.

Release packaging includes:

• Prebuilt Rust binaries attached to GitHub Releases.
• agent-sdk/dist/bridge.js in the npm package.
• A copied Node runtime next to the Rust binary when postinstall can validate it.
• Fallback to node on PATH when the copied runtime is unavailable.

Source builds are different: cargo build or cargo install --path . produce only the Rust binary. They do not build or install the JavaScript bridge. Build the bridge with npm and provide it through the checkout fallback, --bridge-script, or CLAUDE_RS_AGENT_BRIDGE.

Boundaries

Claude Code Rust owns the terminal UI, local settings surface, bridge process management, and event rendering. Anthropic owns the Agent SDK, authentication, service behavior, billing, models, and upstream Claude Code semantics.

The project does not depend on Agent SDK package subpath exports such as /browser, /bridge, or /assistant as the runtime path. The runtime path is the local TypeScript bridge in this repository.

Changelog

The changelog below is included from the repository root CHANGELOG.md.

Changelog

All notable changes to this project will be documented in this file.

[0.12.1] - 2026-05-28 [Changes][v0.12.1]

Documentation

• mdBook manual and GitHub Pages workflow (@srothgan): Add a repo-native manual and Pages deployment workflow.

Fixes

• CLI help examples (@srothgan): Remove the invalid installed-binary --features perf example.

[0.12.0] - 2026-05-21 Changes

Features

• Inline terminal chat runtime (#165, @srothgan): Replace the full-screen chat surface with inline terminal-owned rendering.
• Resolved action-based keymap (#166, @srothgan): Route shortcuts through semantic actions and generate help from the resolved keymap.
• macOS modifier key support (#159, @TomasWeisss): Support Command-key shortcuts in terminal modes.

Fixes

• Inline rendering stability (#165, @srothgan): Stabilize resume, resize, fullscreen return, slash notices, and active-turn state on the inline path.
• Tool-call and diff rendering (#152, #165, #166, @srothgan): Preserve diff indentation, show compact change counts, uncap plan markdown, and keep concrete tool output.
• Agent SDK bridge events (#165, @srothgan): Suppress ToolSearch events, protect the packaged bridge runtime, and accept fractional API retry delays.

UI

• Composer hints and Help tab (#165, #166, @srothgan): Move autocomplete into compact composer rows and Help into fullscreen config.
• Compact inline tools and todos (#165, @srothgan): Render todos inline and tighten standard tool body caps.

Documentation

• README billing and commands cleanup (#165, @srothgan): Document Agent SDK billing changes, custom slash commands, and remove the outdated Architecture section.

CI and Dependencies

• Agent SDK 0.3.146 refresh (#165, @srothgan): Update the Agent SDK bridge dependencies and package locks.
• Rust dependency updates (#151, #154, #155, #156, #157, #158, #160, #161, #162, #163, #164): Bump Rust dependencies and clarify the rand audit ignore.
• rustls-webpki advisory fix (#153): Bump rustls-webpki to 0.103.13 for RUSTSEC-2026-0104.

[0.11.3] - 2026-04-19 Changes

Fixes

• Plan approval Ctrl shortcuts (@srothgan): Replace plain y/n exit-plan approvals with Ctrl+y/Ctrl+n.

[0.11.2] - 2026-04-19 Changes

Features

• Project-local Opus version controls (#146, @srothgan): Add /opus-version to pin the Opus alias per project.

Fixes

• Model alias cleanup and Opus naming (#146, @srothgan): Replace Default with the explicit opus alias and normalize dated Opus labels.
• Dev versus installed bridge resolution (#146, @srothgan): Make cargo run use the repo bridge and installed builds use the bundled bridge.
• Tool-call diff rendering and scrollbar lane (#138, @srothgan): Reserve a dedicated scrollbar column and keep diff content out of it.
• Versioned short model names (#139, @srothgan): Show resolved model versions in short model names.
• Bridge script resolution precedence (#142, @srothgan): Prefer the bundled bridge script and keep repo-local fallback debug-only.
• Update notice warning message (#143, @srothgan): Move upgrade hints from the footer into a warning system message.
• Terminal ANSI output rendering (#144, @srothgan): Preserve command-emitted ANSI colors in terminal tool output.
• Draft-focused inline prompts (#145, @srothgan): Keep pending prompts from stealing draft focus and move prompt handoff to Tab.

CI and Dependencies

• Agent SDK 0.2.112 refresh (#141, @shyal): Bump @anthropic-ai/claude-agent-sdk to 0.2.112, update EXPECTED_AGENT_SDK_VERSION, and refresh 4.7 fixtures.

[0.11.1] - 2026-04-16 Changes

Features

• Folder-local 1M context controls (@srothgan): Add /1m-context enable|disable|status to persist CLAUDE_CODE_DISABLE_1M_CONTEXT in .claude/settings.local.json, preserve neighboring local env keys, surface status, and point 1M-context recovery guidance at the new folder-local fallback

[0.11.0] - 2026-04-16 Changes

Features

• Agent SDK 0.2.104 migration (#135, @srothgan): Upgrade the bundled Claude Agent SDK from 0.2.74 to 0.2.104 across the published package and local bridge; extend the Rust and TypeScript wire contract for current-model snapshots, runtime session state, API retry updates, settings parse errors, terminal reasons, task metadata, prompt suggestions, and refreshed tool metadata
• Live session capability synchronization (#135, @srothgan): Reconcile current model and permission-mode support against the active SDK session instead of assuming startup-time state, and keep session/runtime status aligned through connect, resume, and turn lifecycle changes
• Task patch updates and subagent grouping (#135, @srothgan): Propagate incremental task patches and parent tool linkage so subagent child tool calls collapse under their root task while still surfacing focused hidden permission prompts when user input is required
• Welcome session snapshot and rotating tips (#135, @srothgan): Replace the welcome model badge with a lightweight snapshot showing version, subscription, cwd, and session ID, and rotate curated startup tips across sessions
• Backgrounded tool state badges (#135, @srothgan): Surface assistant-backgrounded Bash commands and backgrounded task state directly in tool cards and summaries

Fixes

• Resume ordering and runtime stability (#135, @srothgan): Preserve resumed history turn ordering and tighten turn/session state handling so reconnects, tool updates, and completion events stay consistent
• External API provider auth handling (#135, @srothgan): Respect external API providers during auth validation instead of assuming the bundled Claude auth path
• Permission and tool-result rendering cleanup (#135, @srothgan): Normalize SDK permission display and tool-result metadata, hide redundant permission headers, and treat killed tool calls as terminal failures in transcript rendering
• Ctrl+V paste path split (#135, @srothgan): Make Ctrl+V exclusively trigger image paste while keeping normal text paste on the standard input path
• Collapsed in-progress subagent summaries (#135, @srothgan): Show substantially more context in collapsed in-progress subagent cards without expanding completed tool calls

Documentation

• Startup limitation note (#135, @srothgan): Document the current end-to-end startup latency constraint from the upstream Claude Agent SDK runtime in README.md

CI and Dependencies

• Bump @anthropic-ai/claude-agent-sdk from 0.2.74 to 0.2.104 in both the published package and bundled bridge (#135, @srothgan)
• Add dedicated agent-sdk CI for audit, lint, and knip, and gate audit failures on direct dependency advisories only (#135, @srothgan)
• Add @anthropic-ai/sdk 0.81.0, @biomejs/biome 2.4.12, and knip 6.4.1 to the bundled bridge toolchain (#135, @srothgan)

[0.10.0] - 2026-04-11 Changes

Features

• Clipboard image pasting (#104, @shyal): Paste images with Ctrl+V, send them as PNG image blocks, and render renumbered inline [Image #N] badges in the draft
• Live git branch tracking (#114, @srothgan): Replace git branch --show-current shell-outs with in-process HEAD parsing and a filesystem watcher so the footer updates while the app stays focused
• Terminal tab activity indicator (#115, @srothgan): Drive the OSC 2 tab title from app state with active and idle indicators and restore the plain cwd title on shutdown
• Resume subcommand and startup picker (#116, @srothgan): Replace the --resume flag with claude-rs resume, add a dedicated startup picker, and cap it to recent project sessions
• App-owned file index with live updates (#117, @srothgan): Move @ mention search to a shared file index with scan streaming, prewarm, and incremental watcher updates across cwd and gitignore changes

Fixes

• Inline turn-scoped limit notices (#118, @srothgan): Dedup rate-limit and plan-limit notices inside the active assistant turn instead of appending duplicate trailing system rows
• Rename watcher convergence (#120, @srothgan): Re-scan parent subtrees on file-index rename events, handle root-level renames, and refresh the yanked unicode-segmentation lockfile entry

Performance

• Structured logging and render-path optimization (#119, @srothgan): Standardize Rust and Agent SDK diagnostics, switch to JSON rolling logs, and cut chat hot-path cost with assembled render caching and cheaper spinner frames

Documentation

• Legal notice expansion (#113, @srothgan): Clarify the project’s relationship to Claude Code, the Agent SDK, Anthropic terms, and the recent source leak

CI and Dependencies

• Bump uuid from 1.22.0 to 1.23.0 (#106, @dependabot)
• Bump notify-rust from 4.12.0 to 4.13.1 (#109, @dependabot)
• Bump similar from 2.7.0 to 3.0.0 (#110, @dependabot)
• Bump tokio from 1.50.0 to 1.51.0 (#111, @dependabot)

Project

• Collaboration template cleanup (#121, @srothgan): Simplify PR and issue templates, collapse CODEOWNERS, and align CONTRIBUTING.md with the current workflow

[0.9.0] - 2026-03-26 Changes

Features

• Two-line footer replaces header (#102): Remove the header and consolidate location, branch, mode badges, permission counts, and MCP auth hints into a two-row adaptive footer

Fixes

• Unified viewport geometry handling (#101): Single geometry entry point with separate width/height semantics and tail invalidation on topology changes
• Centralized geometry state and wrapped panel measurement (#101): Immediate resize geometry refresh and wrapped-text measurement replacing fixed-height panel assumptions
• Topology invalidation and batch message dirtiness (#101): Tracked insert/remove/clear paths own tool index and terminal ref repair
• Active turn ownership across history pruning (#101): Keep active assistant turn out of retention drop candidates and remap ownership after pruning
• Scroll anchor preservation (#101): Delay anchor restore until heights are exact and preserve anchors across pruning and marker operations
• Unified message layout model (#101): Shared MessageLayout replaces split role-specific render/measure branches
• Turn cleanup normalization (#101): Single cleanup boundary for resume, cancel, auth-required, connection-failure, and fatal exits
• Chat focus ownership (#101): Rebuild focus from surviving state on transitions and render selected prompt choices in rust orange
• Streaming invalidation and selection snapshots (#101): Refresh selection snapshots on redraw and protect active streaming assistant in cache budgeting
• Session state reset at authority boundaries (#101): Scope async responses to the active session epoch and discard stale results
• Persisted authority reconciliation (#101): Rederive trust state from current cwd on reconnect and clear stale session identity on failure boundaries
• Tool index rebuilds and multi-index sync (#101): Gate scope updates on successful lookup and normalize interaction queues to prevent stale prompt drops
• Display-width-aware copy (#101): Slice copied text by display columns so emoji, CJK, and combining marks match visual selection
• Esc cancel and queued submit lifecycle (#101): Clear deferred submit on Esc and let manual cancel override auto-resubmit

Performance

• Offscreen row skip and wrapped-height culling (#101): Render from the first visible message’s structural offset and use exact wrapped row coverage for culling

[0.8.4] - 2026-03-23 Changes

Fixes

• Chat bottom-height drift: Stop rendering and measuring the trailing separator row after the final chat message so auto-scroll no longer lands on a persistent empty line beneath the last Claude response; add regression tests for last-message rendering and height measurement

[0.8.3] - 2026-03-23 Changes

Performance

• Unified layout invalidation and progressive remeasure (#98): Replace the dirty_from suffix watermark with per-message staleness tracking, separated prefix-sum dirtiness, and a visible-first remeasure plan; preserve scroll anchors across in-flight resize and global remeasure replacement; single-message updates do exact changed-message remeasure plus targeted prefix repair instead of invalidating the entire suffix
• Incremental history retention accounting (#98): Cache per-message retained-byte estimates and maintain a rolling total so retention enforcement stops rescanning the full message list every cycle; cache tool raw_input byte estimates to avoid repeated JSON serialization in hot paths
• Incremental render cache budget (#98): Replace per-frame full cache budget scans with incremental slot metadata, rolling byte totals, and a pre-sorted eviction set rebuilt only when over budget
• Derive tool collapse state at render time (#98): Remove per-tool collapsed field; tools_collapsed is the session-level source of truth read at render time so Ctrl+O no longer walks and mutates every tool-call block
• Index terminal tool-call refs (#98): Replace linear duplicate checks on terminal subscriptions with a HashSet membership index; route attach, detach, and rebuild through shared tracking helpers

Dependencies

• Bump aws-lc-sys from 0.38.0 to 0.39.0 and aws-lc-rs from 1.16.1 to 1.16.2 (fixes RUSTSEC-2026-0044, RUSTSEC-2026-0048)
• Bump rustls-webpki from 0.103.9 to 0.103.10 (fixes RUSTSEC-2026-0049)
• Bump pulldown-cmark from 0.13.1 to 0.13.3 (#97)

[0.8.2] - 2026-03-18 Changes

Fixes

• Startup service status handling: Keep startup Claude service warnings and errors as transcript messages only; status errors no longer clear the draft or block users from trying a request during partial or uneven outages

[0.8.1] - 2026-03-18 Changes

Fixes

• Startup session settings propagation: Pass configured model and defaultPermissionMode through the SDK’s top-level session startup options so new sessions start with the expected live model and permission mode instead of falling back to provisional defaults
• Welcome banner model sync: Keep the welcome banner and header aligned through Connecting..., provisional default, and the first authoritative model update; freeze the welcome banner once the session model is resolved while allowing the header to continue tracking live model changes
• Claude status relevance filtering: Query the status summary endpoint and only surface startup warnings for Claude Code and Claude API, avoiding false-positive outage banners caused by unrelated Anthropic components
• Config cleanup: Remove obsolete MCP callback overlay code and stale config UI expectations left behind by the MCP management changes

[0.8.0] - 2026-03-17 Changes

Features

• Agent SDK 0.2.74 migration (#83): Upgrade from SDK 0.2.63 to 0.2.74; inline session settings replace per-flag overrides; agent progress summaries rendered in task tool-call bodies; model capability badges (adaptive thinking, fast mode, auto mode) shown in settings overlay
• AskUserQuestion support (#83): Dedicated question/response bridge path with horizontal and vertical option layouts; multi-select state tracking; inline annotation editing; question progress indicator; shared focus cycling infrastructure with permissions
• MCP management tab (#89): Live MCP server list with connection status indicators and tool counts; /mcp slash command; server detail overlay with context-aware actions (reconnect, toggle, authenticate, clear auth); OAuth authentication flow with browser launch and manual callback URL entry; elicitation support for URL-based and form-based modes; stale status revalidation with 30-second cooldown auto-reconnect
• Usage tab with quota visualization (#88, closes #87): Dual-source fetching (OAuth API first, CLI fallback); gauge bars with color-coded utilization (green/yellow/red); 5-hour, 7-day, and per-model quota windows; extra credits panel; /usage slash command and r manual refresh; 30-second TTL caching; OAuth credential expiry validation
• Plugin management (#85): Three-section Plugins tab (Installed, Marketplace, Marketplace Sources) with CLI-backed operations; install/enable/disable/update/uninstall actions via overlay dialogs; marketplace source add/remove with text input; MCP capability badges; /plugins slash command; 5-second inventory cache with background refresh
• Status tab and /status command (#80): Session, account, model, and settings information display; lazy account snapshot fetching via SDK; login method labels (Claude Max, API key variants); session name resolution with custom title/summary/prompt fallback chain; memory path and active setting sources display
• Unified syntax highlighting (#84): Replace ansi-to-tui with syntect for theme-aware coloring across shell commands, code blocks, and terminal output; ANSI escape stripping state machine; automatic raw unified diff detection and semantic coloring; language-aware code highlighting with extension-based syntax detection
• Session management enhancements (#83): Repository-scoped session discovery with worktree inclusion; session rename and AI-generated title actions in Status tab; text overlay for rename input with immediate visual feedback
• Tool output metadata (#83): Structured metadata for Bash (assistant-backgrounded badge, token-saver state), ExitPlanMode (ultraplan badge), TodoWrite (verification-needed badge), and Write/Edit (git repository labels in diff headers); MCP resource content typing with URI, MIME type, and blob saved-path hints

Fixes

• Paste-handled Enter suppression (#83): Treat paste-handled Enter as fully consumed in key dispatch; prevent suppressed paste newlines from falling through to non-char cleanup; restores inline multiline paste insertion for sub-1000 character payloads
• Bell notification fallback (#83): Restore bell alongside desktop notifications on terminals without OSC 9 support; keep auto notification routing aligned with pre-settings behavior

UI

• Config tab activation helper (#88): Centralized activate_tab function for consistent tab-switch behavior across /plugins, /status, /usage, /mcp, and keyboard navigation
• Shared text input widget (#85): Reusable text_input_line() and render_text_input_field() components used by Language, Session Rename, and Add Marketplace overlays
• Setting stepping (#85): Left/Right arrow editing for enum settings (Theme, Notifications, EditorMode, DefaultPermissionMode) in config view

Performance

• Progressive resize height recomputation (#90): Replace synchronous full-remeasure on terminal width change with frame-budgeted progressive convergence; scroll anchor preservation across resize; per-message exactness tracking with expanding measurement frontiers around the visible window; measurement budget of max(12, viewport_height) messages and max(256, viewport_height * 8) wrapped lines per frame
• Background file walker for mentions (#81): Replace synchronous BFS with ignore crate WalkBuilder on a background thread; query refinement refilters from cache instead of restarting the walk; pre-computed lowercase path variants eliminate per-sort allocation; bounded channel (1024 entries) with 500-entry drain budget per tick
• Input redraw and cache optimization (#82): Split input versioning into cursor-only and content epochs; syntax highlighting and height measurement caches keyed on content version; key handlers return visibility signals to suppress redraws for non-visual events; Windows paste burst jitter tolerance in pending confirmation window
• Background bash terminal detachment (#86): Detach terminal references when Bash tools reach completed or failed state; skip polling for non-running tools; prevent late bridge progress updates from reopening finalized tools; clear execute terminal references during forced tool finalization
• Dev/test profile tuning (#83): Line-tables-only debug info and disabled incremental builds for faster compilation

Licensing

• Apache-2.0: Switch project license from AGPL-3.0-or-later to Apache-2.0; SPDX single-line identifiers replace full header blocks across all source files

CI and Dependencies

• Bump @anthropic-ai/claude-agent-sdk from 0.2.63 to 0.2.74 (#83)
• Replace ansi-to-tui with syntect 5.3.0 (#84)
• Bump tui-textarea-2 from 0.10.1 to 0.10.2 (#82)
• Add version comparison to release dry-run workflow to skip unchanged versions (#82)

[0.7.1] - 2026-03-12 Changes

Fixes

• npm rollback for installs and releases: Revert active package manager guidance, package scripts, and GitHub release workflows from pnpm back to npm; runtime reinstall guidance now recommends npm install -g
• Leading blank row before Claude text: Trim leading rendered blank rows before the first visible assistant text block while preserving paragraph spacing for later content
• Deferred Enter submit stability: Plain Enter now snapshots and restores the exact draft instead of mutating the input before submit, fixing hidden newline leaks when the cursor is in the middle of the text

[0.7.0] - 2026-03-12 Changes

Features

• Native /login and /logout commands (#67): Shell out to claude auth login/logout with TUI suspend/resume; credential verification reads ~/.claude/.credentials.json directly; skip redundant operations when already authenticated or not authenticated
• User settings system (#74): 14 persisted settings across three JSON files (~/.claude/settings.json, <project>/.claude/settings.local.json, ~/.claude.json); metadata-driven two-column config view with compact narrow-terminal fallback; toggle/cycle/overlay mutation with immediate persistence
• Workspace trust (#74): Startup gated on per-project trust acceptance; path normalization for Windows drive letters, UNC paths, and symlinks; trust state persisted in ~/.claude.json
• Session launch settings (#74): Saved preferences (model, language, permission mode, thinking mode, effort level) propagate into every new session via SessionLaunchSettings; available models flowed back from SDK for dynamic UI
• Cancel-and-resubmit (#68): Submitting while the agent is running cancels the current turn and auto-resubmits once ready; draft stays visible and editable throughout with cancellation spinner banner
• Desktop and bell notifications (#68, #74): NotificationManager tracks terminal focus via DECSET 1004; fires bell + OS-native desktop toasts on permission requests and turn completion when unfocused; channel-based delivery (disabled, bell, OSC 9, desktop) driven by user preference
• Compaction overhaul (#68): /compact keeps chat history and appends a success system message after the turn completes; input and keyboard blocked during compaction; auto-compaction clears silently without a banner
• Cache observability (#69): CacheMetrics accumulator with rate-limited structured tracing; warn-level alerts for high utilization and eviction spikes with cooldown; integration test suite covering the full stream-to-split-to-measure-to-prefix-sums pipeline
• Unified textarea input (#70): Replace snapshot-based input state plus shadow editor with one persistent TextArea as source of truth; fixes wrapped visual-row cursor navigation; & subagent autocomplete now eager, matching @ and / behavior
• Incremental mention search (#74): Replace repeated full rescans with incremental BFS (400 entries/tick budget) and 4-tier ranking; .gitignore awareness with global, local, and nested rule support; search threshold lowered from 3 characters to 1

Fixes

• Permission allow_always persistence (#68, #71): Synthesize persistent addRules fallback when the SDK omits suggestions, fixing silent degradation to one-time allow; allow_always fallback now persists to localSettings
• Paste burst reliability (#71): Reworked burst detection into a timing-based state machine (Idle/Pending/Buffering) with idle flush; retro-capture cleanup for leaked leading characters; enter suppression during and immediately after paste; CRLF normalized to LF in insert_str
• Bridge reject_once match arm (#68): Added missing match arm that caused spurious warning logs on every permission prompt

UI

• Help panel keyboard navigation (#67): Up/Down scroll and selection for Slash Commands and Subagents tabs; dynamic visible-item computation from wrapped text heights; fixed panel height across tabs; orange highlight for selected item
• Paragraph gap preservation (#74): TextBlock state with trailing spacing metadata preserves paragraph gaps in chat rendering
• Built-in slash entries (#74): /config, /login, /logout appear in slash help and autocomplete
• Input blocking during async commands (#67): General CommandPending status with dynamic spinner text used by /login, /logout, /mode, /model, /new-session, /resume

Performance

• Capacity-based byte accounting (#69): Replace heuristic message sizing with IncrementalMarkdown::text_capacity measurement
• Protected-bytes tracking (#69): Non-evictable streaming-tail blocks excluded from eviction targets in render budget enforcement
• Layout invalidation consolidation (#69): InvalidationLevel enum and invalidate_layout helper replace ad-hoc invalidation across event flows

Refactoring

• Codebase split (#68): ui/tool_call.rs, app/connect.rs, app/slash.rs, app/state.rs, app/events.rs split into submodule directories (4-9 files each); bridge.ts split into 8 files under bridge/; all public APIs preserved via re-exports
• Usage pipeline removal (#68): Delete entire usage_update pipeline (bridge/usage.ts, UsageUpdate types, session/message token tracking, footer cost display) across TypeScript and Rust
• Input state unification (#70): Remove rebuild/sync debt from snapshot-based input; route all input reads/writes through accessor + replace flows on a single TextArea instance

CI and Dependencies

• Bump uuid from 1.21.0 to 1.22.0 (#72)
• Bump which from 8.0.0 to 8.0.2 (#73)
• Switch tui-textarea-2 from local path dependency to crates.io 0.10.1 (#70)
• Switch remaining npm command surfaces to pnpm across workflows, docs, and scripts (#74)

[0.6.0] - 2026-03-03 Changes

Features

• Agent SDK 0.2.63 migration (#64): Upgrade from SDK 0.2.52 to 0.2.63; align bridge, wire types, and session APIs with the new SDK surface
• Fast mode support (#64): Wire fast mode state end-to-end from bridge to TUI; footer badge shows FAST or FAST:CD during cooldown; deduplicated state change emission
• Rate limit updates (#64): Parse and display rate limit events with readable user-facing summaries including overage and reset timing
• Available agents and subagent autocomplete (#64): Wire available_agents_update across bridge and rust layers; & ampersand autocomplete for subagents; new Subagents help tab with two-column layout
• Session resume via SDK-native APIs (#64): Replace legacy JSONL parsing with resume_session backed by listSessions and getSessionMessages; align to SDK session metadata fields
• Interactive plan approval (#61): Intercept ExitPlanMode and render structured Approve/Reject widget with arrow navigation, y/n quick shortcuts, and allowedPrompts display
• Write diff capping (#61): Truncate Write tool diffs exceeding 50 lines to head/tail window with omission marker; auto-scroll on oversized writes; plan files exempted
• Startup service status checks (#65): Query status.claude.com during startup; emit warning or error system messages; lock input on outage-level errors
• Subagent thinking indicator (#60): Debounced (1500ms) idle indicator between subagent tool calls to avoid flicker; suppress normal spinner when subagent indicator is active
• System message severity levels (#64): Replace SystemWarning with MessageRole::System plus Info/Warning/Error severity with matching label colors
• Slash command output in transcript (#64): Local slash command results now surface in assistant transcript

Fixes

• Context percentage formula (#61): Exclude output_tokens from context calculation – Anthropic input formula is cache_read + cache_creation + input only; context % now updates as soon as input_tokens arrive
• Stale task scope cleanup (#65): Clear active_task_ids on tool scope reset to prevent subagent misclassification after cancelled tasks
• Subagent indicator false positives (#65): Gate thinking indicator on active spinner state to prevent false idle rendering
• SDK rejection sanitization (#65): Harden bridge rejection replacement with exact and known-prefix matching only on failed tool results
• Saturating coordinate math (#65): Use saturating arithmetic for header, input, autocomplete, and todo padding to prevent overflow panics

UI

• Footer module extraction (#61): Move all footer logic into dedicated src/ui/footer.rs; clean up imports in mod.rs
• Autocomplete stabilization (#61): Stable popover width; shift left near right edge; UTF-8-safe case-insensitive highlight ranges
• Help overlay improvements (#64): Add subagents tab; move tab-switch hint into help title; rename footer hint from “Shortcuts + Commands” to “Help”

Refactoring

• Handler decomposition (#61): Split large connection/event/key/slash/message handlers into smaller helpers; remove clippy::too_many_lines suppressions; FocusContext builder-style API

CI and Dependencies

• Bump actions/upload-artifact from 6 to 7 (#62)
• Bump actions/download-artifact from 7 to 8 (#63)
• Migrate from npm package-lock.json to pnpm pnpm-lock.yaml in agent-sdk (#64)

[0.5.1] - 2026-02-27 Changes

Fixes

• Input smoothness during rapid keys: Restore frame rendering during non-paste active key bursts by narrowing suppression to confirmed paste bursts only; preserves paste placeholder anti-flicker behavior

[0.5.0] - 2026-02-27 Changes

Features

• Paste handling overhaul (#53): Character-count threshold (1000 chars) replaces line-count; placeholder label updated; session identity tracking prevents append across separate pastes; burst finalization scoped to newly pasted range only
• Turn error classification (#54): TurnError strings matched against known patterns (rate limit, plan limit, max turns, quota, 429); actionable recovery hint pushed as a system message in chat; unclassified errors preserve existing behavior

Fixes

• Typed AppError enum (#54): NodeNotFound, AdapterCrashed, AuthRequired, ConnectionFailed, SessionNotFound variants with per-variant exit codes and user-facing messages

Performance

• Unified cache budgeting + LRU history retention (#52): Single cache budget across all message blocks; LRU eviction for long sessions; reduces memory growth on extended conversations

UI

• Footer three-column layout: Update hint and context percentage now render in separate right-aligned columns simultaneously instead of either-or

[0.4.1] - 2026-02-27 Changes

Fixes

• Dynamic bridge log levels (client.rs): Bridge stderr lines are now routed to the correct tracing level – [sdk error]/panic lines go to error!, [sdk warn] lines to warn!, and ordinary SDK chatter to debug! – instead of unconditionally emitting error! for every line
• Height cache invalidated on interruption (events.rs): TurnComplete and TurnError now call mark_message_layout_dirty on the tail assistant message so the height cache is re-measured after a cancelled or failed turn, fixing stale layout after interruption

[0.4.0] - 2026-02-27 Changes

Features

• Agent SDK migration (#45, closes #23): Replace @zed-industries/claude-code-acp with the in-repo Agent SDK bridge; align permission suggestions with SDK session/always-allow scope
• Session resume (#46, closes #22): --resume is cwd-aware and restores full transcript state; input locked while resuming; recent sessions shown in welcome context
• Token and cost tracking (#47, closes #21): Footer shows live Context: XX%; assistant turns show per-turn (Xk tok / $X.XX); compaction spinner during SDK-reported compaction
• Slash command popovers and AskUserQuestion (#48): Variable-input slash commands show dynamic argument popovers; full AskUserQuestion flow with option rendering and answer propagation

Fixes

• TodoWrite flicker (#45): Ignore transient payloads without a todos array so the list no longer clears and reappears mid-turn
• Failed Bash rendering (#45): Compress failed tool output to a single exit-code summary line instead of the full stderr dump
• Ctrl+C determinism (#46): Copy only when selection is non-empty and clear it after; otherwise quit
• Submission pipeline (#47): Single queue gate for submissions; cancel active turn before dispatching queued action; wait for turn-settle before ready
• Persisted tool-result normalization (#48): Strip leading box-drawing prefixes from tool result summaries

Performance

• Streaming frame cost (#49): Generation-keyed tool call measurement cache with O(1) fast path; terminal output delta-append; skip invalidation for no-op updates

Internal

• Agent SDK bridge modularized into focused modules (commands.ts, tooling.ts, permissions.ts, usage.ts, history.ts, auth.ts, shared.ts) (#48)
• Perf instrumentation markers for key invalidation, measurement, and snapshot paths (#49)

[0.3.0] - 2026-02-25 Changes

Features

• Startup update check (#30): Non-blocking check via GitHub Releases API with 24h cache, footer hint, Ctrl+U dismiss, --no-update-check / CLAUDE_RUST_NO_UPDATE_CHECK=1 opt-out
• Shortcuts during connecting (#38): Navigation and help shortcuts work while ACP adapter connects; input keys remain blocked
• Global Ctrl+Q quit (#38): Safe quit available in all states including connecting and error
• Input height API and word wrapping (#40): Adopt tui-textarea-2 v0.10 TextArea::measure() for input sizing, switch to WrapMode::WordOrGlyph, remove custom InputWrapCache plumbing

Fixes

• Height cache recalculation (#39): Track dirty message index and re-measure non-tail messages when content or tool blocks change
• Error state and input locking (#39): Connection and turn failures surface immediately with quit hint; input blocked during connecting/error
• Scroll clamp after permission collapse (#39): Clamp overscroll when content shrinks; ease scroll position for smooth settling; consume Up/Down with single pending permission
• Permission shortcut reliability (#29): Ctrl+Y/A/N work globally while prompts are pending with fallback option matching
• Tool-call error rendering (#29): Improved error handling with raw_output fallback and cleaner failed-call display

CI and Dependencies

• Bump actions/upload-artifact 4 to 6, actions/setup-node 4 to 6, actions/download-artifact 5 to 7 (#31, #32, #33)
• Bump pulldown-cmark from 0.13.0 to 0.13.1 (#34)
• Unify cargo publish, binary build, GitHub release, and npm publish into one workflow (#30)
• Add revert to allowed semantic PR title types (#37)

Internal

• Attempted migration to claude-agent-acp (#29), reverted to claude-code-acp (#37) due to feature parity gaps
• Regression tests for height remeasurement, scroll clamp, permission keys, connecting shortcuts, and update check

[0.2.0] - 2026-02-22 Changes

Rename and Distribution

• Rename crate/package to claude-code-rust
• Rename command to claude-rs
• Update release workflows and artifacts to publish/build under the new names

[0.1.3] - 2026-02-21 Changes

Fixes

• Rescan files on each @ mention activation so new/deleted files are reflected during a session
• Add keywords to npm package.json for better discoverability

[0.1.2] - 2026-02-21 Changes

UX and Interaction

• Add OS-level shutdown signal handling (Ctrl+C/SIGTERM) so external interrupts also trigger graceful TUI teardown
• Keep in-app Ctrl+C key behavior for selection copy versus quit, while unifying shutdown through the existing cleanup path
• Make chat scrollbar draggable with proportional thumb-to-content mapping
• Ensure scrollbar dragging can reach absolute top and bottom of chat history

[0.1.1] - 2026-02-21 Changes

CI and Release

• Replace release-plz with direct cargo and npm publish workflows
• release-cargo.yml: publishes to crates.io on Cargo.toml version bump
• release-npm.yml: builds cross-platform binaries, creates verified GitHub Release, publishes to npm with provenance
• Triggers based on Cargo.toml version changes instead of tag chaining
• Tags created by github-actions[bot] for verified provenance
• Remove release-plz.toml and cliff.toml

[0.1.0] - 2026-02-20 Changes

Release Summary

Claude Code Rust reaches a strong pre-1.0 baseline with near feature parity for core Claude Code terminal workflows:

• Native Rust TUI built with Ratatui and Crossterm
• ACP protocol integration via @zed-industries/claude-code-acp
• Streaming chat, tool calls, permissions, diffs, and terminal command output
• Modern input UX (multiline, paste burst handling, mentions, slash commands)
• Substantial rendering and scrolling performance work for long sessions
• Broad unit and integration test coverage across app state, events, permissions, and UI paths

The only major parity gap intentionally excluded from this release is token/cost usage display because the upstream ACP adapter currently does not emit usage data.

Architecture And Tooling

• Three-layer runtime design:
  • Presentation: Rust + Ratatui
  • Protocol: ACP over stdio
  • Agent: Zed ACP adapter process
• Async runtime and event handling:
  • Tokio runtime with ACP work kept on LocalSet (!Send futures)
  • mpsc channels between ACP client events and UI state machine
• CLI and platform support:
  • Clap-based CLI (--model, --resume, --yolo, -C, adapter/log/perf flags)
  • Cross-platform adapter launcher fallback (explicit path, env path, global bin, npx)
  • Windows-safe process resolution via which

Core Features

• Chat and rendering:
  • Native markdown rendering including tables
  • Inline code/diff presentation and tool-call block rendering
  • Welcome/system/tool content unified in normal chat flow
• Input and commands:
  • tui-textarea-2 powered editor path
  • Multiline paste placeholder pipeline and burst detection
  • @ file/folder mention autocomplete with resource embedding
  • Slash command workflow with ACP-backed filtering and help integration
• Tool execution UX:
  • Unified inline permission controls inside tool-call blocks
  • Focus-aware keyboard routing for mention, todo, and permission contexts
  • Better interruption semantics and stale spinner cleanup
  • Internal ACP/adapter failures rendered distinctly from normal command failures
• Session and app UX:
  • Parallel startup (TUI appears immediately while ACP connects in background)
  • In-TUI connecting/auth failure messaging and login hinting
  • Header model/location/branch context
  • Help overlay and shortcut discoverability improvements
  • Mouse selection and clipboard copy support
  • Smooth chat scroll and minimal scroll position indicator

Performance Work

Performance optimization was a major release theme across recent commits:

• Block-level render caching and deduplicated markdown parsing
• Incremental markdown handling in streaming scenarios
• Prefix sums + binary search for first visible message
• Viewport culling for long-chat scaling
• Ground-truth height measurement and improved resize correctness
• Conditional redraw paths and optional perf diagnostics logging
• Additional targeted UI smoothing for scroll and scrollbar transitions

Reliability, Quality, And Tests

• Significant test investment across both unit and integration layers
• Current codebase includes over 400 Rust #[test] cases
• Dedicated integration suites for ACP events, tool lifecycle, permissions, state transitions, and internal failure rendering
• CI includes test, clippy (-D warnings), fmt, MSRV, and lockfile checks

Release And Distribution Setup

• Rust crate is now publish-ready for crates.io as claude-code-rust
• CLI executable name is claude-rs
• npm global package added as claude-code-rust:
  • installs claude-rs command
  • downloads matching GitHub release binary during postinstall
• Tag-based GitHub Actions release workflow added for:
  • cross-platform binary builds (Windows/macOS/Linux)
  • GitHub release asset publishing
  • npm publishing (when NPM_TOKEN is configured)
• release-plz remains in place for release PR automation and changelog/version workflows

Known Limitations

• Slash command availability is intentionally conservative for this release:
  • /login and /logout are not offered
  • they remain excluded until ACP/Zed support is reliable enough for production use
• Token usage and cost tracking is blocked by current ACP adapter behavior:
  • UsageUpdate events are not emitted
  • PromptResponse.usage is None
• Session resume (--resume) is blocked on an upstream adapter release that contains a Windows path encoding fix