mirror of
https://github.com/lWolvesl/claw-code.git
synced 2026-04-02 07:41:52 +08:00
8d4a739c05
The custom crossterm editor now supports prompt history, slash-command tab completion, multiline editing, and Ctrl-C semantics that clear partial input without always terminating the session. The live REPL loop now distinguishes buffer cancellation from clean exit, persists session state on meaningful boundaries, and renders tool activity in a more structured way for terminal use. Constraint: Keep the active REPL on the existing crossterm path without adding a line-editor dependency Rejected: Swap to rustyline or reedline | broader integration risk than this polish pass justifies Confidence: medium Scope-risk: moderate Reversibility: clean Directive: Keep editor state logic generic in input.rs and leave REPL policy decisions in main.rs Tested: cargo fmt --manifest-path rust/Cargo.toml --all; cargo clippy --manifest-path rust/Cargo.toml --all-targets --all-features -- -D warnings; cargo test --manifest-path rust/Cargo.toml Not-tested: Interactive manual terminal smoke test for arrow keys/tab/Ctrl-C in a live TTY
Rusty Claude CLI
rust/ contains the Rust workspace for the integrated rusty-claude-cli deliverable.
It is intended to be something you can clone, build, and run directly.
Workspace layout
rust/
├── Cargo.toml
├── Cargo.lock
├── README.md
└── crates/
├── api/ # Anthropic API client + SSE streaming support
├── commands/ # Shared slash-command metadata/help surfaces
├── compat-harness/ # Upstream TS manifest extraction harness
├── runtime/ # Session/runtime/config/prompt orchestration
├── rusty-claude-cli/ # Main CLI binary
└── tools/ # Built-in tool implementations
Prerequisites
- Rust toolchain installed (
rustup, stable toolchain) - Network access and Anthropic credentials for live prompt/REPL usage
Build
From the repository root:
cd rust
cargo build --release -p rusty-claude-cli
The optimized binary will be written to:
./target/release/rusty-claude-cli
Test
Run the verified workspace test suite used for release-readiness:
cd rust
cargo test --workspace --exclude compat-harness
Quick start
Show help
cd rust
cargo run -p rusty-claude-cli -- --help
Print version
cd rust
cargo run -p rusty-claude-cli -- --version
Usage examples
1) Prompt mode
Send one prompt, stream the answer, then exit:
cd rust
cargo run -p rusty-claude-cli -- prompt "Summarize the architecture of this repository"
Use a specific model:
cd rust
cargo run -p rusty-claude-cli -- --model claude-sonnet-4-20250514 prompt "List the key crates in this workspace"
Restrict enabled tools in an interactive session:
cd rust
cargo run -p rusty-claude-cli -- --allowedTools read,glob
2) REPL mode
Start the interactive shell:
cd rust
cargo run -p rusty-claude-cli --
Inside the REPL, useful commands include:
/help
/status
/model claude-sonnet-4-20250514
/permissions workspace-write
/cost
/compact
/memory
/config
/init
/diff
/version
/export notes.txt
/session list
/exit
3) Resume an existing session
Inspect or maintain a saved session file without entering the REPL:
cd rust
cargo run -p rusty-claude-cli -- --resume session.json /status /compact /cost
You can also inspect memory/config state for a restored session:
cd rust
cargo run -p rusty-claude-cli -- --resume session.json /memory /config
Available commands
Top-level CLI commands
prompt <text...>— run one prompt non-interactively--resume <session.json> [/commands...]— inspect or maintain a saved sessiondump-manifests— print extracted upstream manifest countsbootstrap-plan— print the current bootstrap skeletonsystem-prompt [--cwd PATH] [--date YYYY-MM-DD]— render the synthesized system prompt--help/-h— show CLI help--version/-V— print the CLI version and build info locally (no API call)--output-format text|json— choose non-interactive prompt output rendering--allowedTools <tool[,tool...]>— restrict enabled tools for interactive sessions and prompt-mode tool use
Interactive slash commands
/help— show command help/status— show current session status/compact— compact local session history/model [model]— inspect or switch the active model/permissions [read-only|workspace-write|danger-full-access]— inspect or switch permissions/clear [--confirm]— clear the current local session/cost— show token usage totals/resume <session-path>— load a saved session into the REPL/config [env|hooks|model]— inspect discovered Claude config/memory— inspect loaded instruction memory files/init— create a starterCLAUDE.md/diff— show the current git diff for the workspace/version— print version and build metadata locally/export [file]— export the current conversation transcript/session [list|switch <session-id>]— inspect or switch managed local sessions/exit— leave the REPL
Environment variables
Anthropic/API
ANTHROPIC_AUTH_TOKEN— preferred bearer token for API authANTHROPIC_API_KEY— legacy API key fallback if auth token is unsetANTHROPIC_BASE_URL— override the Anthropic API base URLANTHROPIC_MODEL— default model used by selected live integration tests
CLI/runtime
RUSTY_CLAUDE_PERMISSION_MODE— default REPL permission mode (read-only,workspace-write, ordanger-full-access)CLAUDE_CONFIG_HOME— override Claude config discovery rootCLAUDE_CODE_REMOTE— enable remote-session bootstrap handling when supportedCLAUDE_CODE_REMOTE_SESSION_ID— remote session identifier when using remote modeCLAUDE_CODE_UPSTREAM— override the upstream TS source path for compat-harness extractionCLAWD_WEB_SEARCH_BASE_URL— override the built-in web search service endpoint used by tooling
Notes
compat-harnessexists to compare the Rust port against the upstream TypeScript codebase and is intentionally excluded from the requested release test run.- The CLI currently focuses on a practical integrated workflow: prompt execution, REPL operation, session inspection/resume, config discovery, and tool/runtime plumbing.