Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

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 crate version in the root Cargo.toml and the Changelog are the source of truth for the current release.

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.

Claude CLI Dependencies

Core conversations, tools, file edits, permissions, and session history run through the bundled Agent SDK. The separately installed claude command is used for the following operations and must be available on PATH when you use them:

OperationCLI commandWhen it is needed
/login and /logoutclaude auth login and claude auth logoutAccount sign-in and sign-out from the Rust TUI. An already authenticated SDK session does not invoke these commands for each turn.
Plugin inventory and managementclaude plugin ...Listing installed and available plugins; installing, enabling, disabling, updating, and uninstalling plugins; and managing marketplaces. Installed plugins execute through the SDK, and runtime reload uses the SDK.
Remove a persisted MCP serverclaude mcp remove --scope <scope> <server>Removing user-, project-, or local-scope server configuration. Dynamic session servers are removed through the SDK.
Usage data from the CLIclaude /usage --allowed-tools ""When the CLI usage source is selected, or an eligible fallback reaches it. The default source first tries the connected SDK session, then OAuth; only eligible OAuth failures fall back to the CLI.

This list was audited against Agent SDK 0.3.286 on October 2, 2026, by checking the application’s CLI process launches and usage-source selection. Installing claude provides these operations; it does not add the stock terminal interface’s other screens or controls to the Rust TUI.

Feature Overview

The Rust TUI implements its own interface and uses the SDK’s session capabilities. It does not reproduce every stock Claude Code interface feature.

FeatureAvailabilityDetails
Conversations, tools, file edits, and permissionsRust TUI and SDKCore interactive workflow.
Model, effort, permission mode, and agent selectionRust TUI and SDKAvailable through startup flags and session controls.
Resume, continue, compaction, and rewindRust TUI and SDKSession startup and history controls; see Usage and Slash Commands.
Subagents and background tasks within a sessionRust TUI and SDKSDK task activity and results are displayed in the conversation. This is distinct from detaching the entire session.
Skills and SDK-advertised slash commandsSDK, when advertisedUse /docs commands for the current session’s merged list.
MCP status, authorization, and dynamic serversRust TUI and SDKPersisted server removal additionally needs the CLI, as listed above.
Inline edit diffsRust TUITool output displays file changes.
Shell completions and man pagesNative CLIGenerated from the CLI definitions; see Usage.
Account login and logoutInstalled Claude CLIInvoked from /login and /logout.
Plugin inventory and persistent managementInstalled Claude CLIInvoked from the plugin management interface.
Session-only local plugin foldersRust TUI and SDKLoad local folder in /plugins; no persistent installation.
Usage informationSDK, OAuth, or installed Claude CLIThe CLI is conditional; see the dependency table above.
Whole-session background detach/attach and stock agent viewUnavailable in the Rust TUISDK background tasks are supported, but the stock /background and claude agents interface is not provided.
Remote Control and stock IDE integrationsUnavailable in the Rust TUINo equivalent to the stock /remote-control or /ide integration. Running in an IDE terminal still works.
Vim input modeUnavailable in the Rust TUIThe settings surface does not offer an editor-mode preference; see unavailable settings.
Dedicated /diff review panelUnavailable in the Rust TUIInline edit diffs remain available.
Stock /tui renderer switchUnavailable in the Rust TUIRendering and fullscreen settings screens are owned by the Rust application.
Mouse interaction with app controlsUnavailable in the Rust TUIUse keyboard controls. Terminal text selection and native scrollback depend on your terminal.

The comparison was checked against the official Claude Code command reference, the app-owned command definitions, and a metadata-only supportedCommands() query using SDK 0.3.286. The SDK list varies with account, platform, configuration, and installed skills; it is not the stock CLI’s complete /help menu. A missing SDK command alone is not evidence that a capability is unavailable. The interface gaps above were also checked against the Rust and bridge implementations. For the upstream integrations, see Remote Control and VS Code.

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:

Billing Note

Because Claude Code Rust uses the Agent SDK, usage should be treated as Agent SDK usage. Anthropic has paused the previously announced Agent SDK credit change. For now, Agent SDK usage, including claude -p and third-party apps like this one, still draws from normal Claude subscription limits.

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