@srothgan/claude-code-rust-darwin-x64 0.13.2 → 0.13.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +8 -94
- package/bin/claude-rs +0 -0
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,101 +1,15 @@
|
|
|
1
|
-
#
|
|
1
|
+
# `@srothgan/claude-code-rust-darwin-x64`
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
This is the **x86_64-apple-darwin** native binary package for [claude-code-rust](https://github.com/srothgan/claude-code-rust#readme) version `0.13.3`.
|
|
4
4
|
|
|
5
|
-
|
|
6
|
-
[](https://www.npmjs.com/package/claude-code-rust)
|
|
7
|
-
[](https://github.com/srothgan/claude-code-rust/actions/workflows/pr.yml)
|
|
8
|
-
[](https://srothgan.github.io/claude-code-rust/)
|
|
9
|
-
[](https://www.apache.org/licenses/LICENSE-2.0)
|
|
10
|
-
[](https://nodejs.org/)
|
|
11
|
-
|
|
12
|
-
<p align="center">
|
|
13
|
-
<img src="assets/banner.png" alt="Claude Code Rust running a Read tool call with syntax-highlighted output" width="900">
|
|
14
|
-
</p>
|
|
15
|
-
|
|
16
|
-
## About
|
|
17
|
-
|
|
18
|
-
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.
|
|
19
|
-
|
|
20
|
-
## Requisites
|
|
21
|
-
|
|
22
|
-
- Node.js 18+ (for the Agent SDK bridge)
|
|
23
|
-
- Existing Claude Code authentication (`~/.claude/config.json`)
|
|
24
|
-
|
|
25
|
-
## Install
|
|
26
|
-
|
|
27
|
-
### npm (global, recommended)
|
|
5
|
+
Install `claude-code-rust` instead; this package is selected automatically as an optional dependency on matching platforms.
|
|
28
6
|
|
|
29
7
|
```bash
|
|
30
8
|
npm install -g claude-code-rust
|
|
31
9
|
```
|
|
32
10
|
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
npm config get omit
|
|
39
|
-
npm install -g claude-code-rust
|
|
40
|
-
```
|
|
41
|
-
|
|
42
|
-
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.
|
|
43
|
-
|
|
44
|
-
## Usage
|
|
45
|
-
|
|
46
|
-
```bash
|
|
47
|
-
claude-rs
|
|
48
|
-
```
|
|
49
|
-
|
|
50
|
-
Full documentation is available at [srothgan.github.io/claude-code-rust](https://srothgan.github.io/claude-code-rust/).
|
|
51
|
-
|
|
52
|
-
> [!NOTE]
|
|
53
|
-
> **Agent SDK billing unchanged.** Anthropic has paused the previously announced Agent SDK credit change. For now nothing changes: Claude Agent SDK usage — including `claude -p` and third-party apps like this one — still draws from your normal Claude subscription limits. See [Use the Claude Agent SDK with your Claude plan](https://support.claude.com/en/articles/15036540-use-the-claude-agent-sdk-with-your-claude-plan).
|
|
54
|
-
|
|
55
|
-
## Why
|
|
56
|
-
|
|
57
|
-
The stock Claude Code TUI runs on Node.js with React Ink, which renders by redrawing full frames over raw ANSI escape codes. This causes real, widely-reported problems:
|
|
58
|
-
|
|
59
|
-
- **Flickering**: The whole view is redrawn on every status update, causing constant flicker — bad enough to crash editors' integrated terminals during long sessions
|
|
60
|
-
- **CPU**: Sustained high CPU even when idle, and runaway loops that spawn multiple background processes
|
|
61
|
-
- **Memory**: 200-400MB baseline (and climbing with conversation length) vs ~20-50MB for a native binary
|
|
62
|
-
- **Resize**: Window resizing leaves duplicated frames in scrollback, loses lines when shrinking, and can garble the display
|
|
63
|
-
- **Input latency**: Keystrokes echo with visible delay as context fills up, and noticeably worse on Windows
|
|
64
|
-
- **Scrollback**: Hijacks the terminal's native scrollback, erasing history you can no longer scroll back to
|
|
65
|
-
- **Paste**: Large pastes can flood stdout and freeze the terminal
|
|
66
|
-
|
|
67
|
-
Claude Code Rust addresses these by compiling to a single native binary with diffed, direct terminal control via Crossterm and Ratatui — no full-frame redraws, no Node runtime overhead.
|
|
68
|
-
|
|
69
|
-
## Documentation
|
|
70
|
-
|
|
71
|
-
The manual covers installation from npm and source, help, slash commands, keyboard shortcuts, settings, diagnostics, architecture, and the changelog:
|
|
72
|
-
|
|
73
|
-
- [Installation](https://srothgan.github.io/claude-code-rust/installation.html)
|
|
74
|
-
- [Usage](https://srothgan.github.io/claude-code-rust/usage.html)
|
|
75
|
-
- [Help](https://srothgan.github.io/claude-code-rust/help.html)
|
|
76
|
-
- [Slash commands](https://srothgan.github.io/claude-code-rust/commands.html)
|
|
77
|
-
- [Settings](https://srothgan.github.io/claude-code-rust/settings.html)
|
|
78
|
-
|
|
79
|
-
## Status
|
|
80
|
-
|
|
81
|
-
This project is pre-1.0 and under active development. See [CONTRIBUTING.md](CONTRIBUTING.md) for how to get involved.
|
|
82
|
-
|
|
83
|
-
## Limitations
|
|
84
|
-
|
|
85
|
-
Startup is still constrained by the upstream Claude Agent SDK runtime that this TUI wraps. The Rust interface itself is fast, but end-to-end readiness can still take noticeable time before a session is fully available. Improving that remains an active area of work.
|
|
86
|
-
|
|
87
|
-
## License
|
|
88
|
-
|
|
89
|
-
This project is licensed under the [Apache License 2.0](LICENSE). Apache-2.0 was chosen to keep usage and redistribution straightforward for individual users, downstream packagers, and commercial adopters.
|
|
90
|
-
|
|
91
|
-
## Disclaimer and Legal Notice
|
|
92
|
-
|
|
93
|
-
This project is not affiliated with, endorsed by, or supported by Anthropic.
|
|
94
|
-
|
|
95
|
-
A quick note on where this project stands, since I know people worry about this kind of thing: claude-code-rust is a terminal UI that I wrote from scratch in Rust. It is not a fork, copy or port of the latest Claude Code source leak -- it talks to Anthropic's official [Agent SDK](https://docs.anthropic.com/en/docs/agents-and-tools/claude-code/agent-sdk) as a runtime dependency instead, the same way any other third-party tool would. No Anthropic source code was read or used as reference at any point during development.
|
|
96
|
-
|
|
97
|
-
The project authenticates through your existing Claude Code account via the Agent SDK, and the Agent SDK's terms allow building on top of it. Billing, credits, limits, and overage behavior are controlled by Anthropic, including any future changes Anthropic may make to how Agent SDK usage is metered. Other community projects do the same. As far as I can tell, using this project is fine -- but I am a single maintainer, not a lawyer. If anything changes on Anthropic's end, I will update this section and adjust the project accordingly.
|
|
98
|
-
|
|
99
|
-
This project's source code is licensed under [Apache-2.0](LICENSE). The Agent SDK itself is proprietary and governed by [Anthropic's Commercial Terms of Service](https://www.anthropic.com/legal/commercial-terms).
|
|
100
|
-
|
|
101
|
-
For official Claude documentation, see [https://claude.ai/docs](https://claude.ai/docs).
|
|
11
|
+
- Rust target: `x86_64-apple-darwin`
|
|
12
|
+
- npm package: [`@srothgan/claude-code-rust-darwin-x64`](https://www.npmjs.com/package/@srothgan/claude-code-rust-darwin-x64)
|
|
13
|
+
- npm platform directory: `darwin-x64`
|
|
14
|
+
- OS: `darwin`
|
|
15
|
+
- CPU: `x64`
|
package/bin/claude-rs
CHANGED
|
Binary file
|