claude-code-rust
v0.6.0
Published
Claude Code Rust - native Rust terminal interface for Claude Code
Downloads
876
Readme
Claude Code Rust
A native Rust terminal interface for Claude Code. Drop-in replacement for Anthropic's stock Node.js/React Ink TUI, built for performance and a better user experience.
About
Claude Code Rust replaces the stock Claude Code terminal interface with a native Rust binary built on Ratatui. It connects to the same Claude API through a local Agent SDK bridge (agent-sdk/dist/bridge.js). Core Claude Code functionality - tool calls, file editing, terminal commands, and permissions - works unchanged.
Requisites
- Node.js 18+ (for the Agent SDK bridge)
- Existing Claude Code authentication (
~/.claude/config.json)
Install
npm (global, recommended)
npm install -g claude-code-rustThe npm package installs a claude-rs command and downloads the matching
prebuilt release binary for your platform during postinstall.
Usage
claude-rsWhy
The stock Claude Code TUI runs on Node.js with React Ink. This causes real problems:
- Memory: 200-400MB baseline vs ~20-50MB for a native binary
- Startup: 2-5 seconds vs under 100ms
- Scrollback: Broken virtual scrolling that loses history
- Input latency: Event queue delays on keystroke handling
- Copy/paste: Custom implementation instead of native terminal support
Claude Code Rust fixes all of these by compiling to a single native binary with direct terminal control via Crossterm.
Architecture
Three-layer design:
Presentation (Rust/Ratatui) - Single binary with an async event loop (Tokio) handling keyboard input and bridge client events concurrently. Virtual-scrolled chat history with syntax-highlighted code blocks.
Agent SDK Bridge (stdio JSON envelopes) - Spawns agent-sdk/dist/bridge.js as a child process and communicates via line-delimited JSON envelopes over stdin/stdout. Bidirectional streaming for user messages, tool updates, and permission requests.
Agent Runtime (Anthropic Agent SDK) - The TypeScript bridge drives @anthropic-ai/claude-agent-sdk, which manages authentication, session/query lifecycle, and tool execution.
Known Limitations
/loginand/logoutare intentionally not offered in command discovery for this release.
Status
This project is pre-1.0 and under active development. See CONTRIBUTING.md for how to get involved.
License
This project is licensed under the GNU Affero General Public License v3.0 or later. This license was chosen because Claude Code is not open-source and this license allows everyone to use it while stopping Anthropic from implementing it in their closed-source version.
By using this software, you agree to the terms of the AGPL-3.0. If you modify this software and make it available over a network, you must offer the source code to users of that service.
Disclaimer
This project is an unofficial terminal UI for Claude Code and is not affiliated with, endorsed by, or supported by Anthropic. Use it at your own risk. For official Claude documentation, see https://claude.ai/docs.
