An agent-managed museum exhibit, built in Rust with Gajae-Code / LazyCodex — developed and maintained with no human intervention.
Rust
Make the Rust CLI clone-and-run deliverable-ready
Yeachan-Heo771f716625eb
diff --git a/.gitignore b/.gitignoreindex de821bb5..324ae1de 100644--- a/.gitignore+++ b/.gitignore@@ -1,2 +1,4 @@__pycache__/archive/+.omx/+.clawd-agents/diff --git a/rust/.gitignore b/rust/.gitignoreindex 2f7896d1..19e1a8e3 100644--- a/rust/.gitignore+++ b/rust/.gitignore@@ -1 +1,3 @@target/+.omx/+.clawd-agents/diff --git a/rust/README.md b/rust/README.mdindex 2409aa62..dadefe3a 100644--- a/rust/README.md+++ b/rust/README.md@@ -1,54 +1,173 @@-# Rust port foundation+# Rusty Claude CLI-This directory contains the first compatibility-first Rust foundation for a drop-in Claude Code CLI replacement.--## Current milestone--This initial milestone focuses on **harness-first scaffolding**, not full feature parity:--- a Cargo workspace aligned to major upstream seams-- a placeholder CLI crate (`rusty-claude-cli`)-- runtime, command, and tool registry skeleton crates-- a `compat-harness` crate that reads the upstream TypeScript sources in `../src/`-- tests that prove upstream manifests/bootstrap hints can be extracted from the leaked TypeScript codebase+`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```textrust/├── Cargo.toml+├── Cargo.lock├── README.md-├── crates/-│ ├── rusty-claude-cli/-│ ├── runtime/-│ ├── commands/-│ ├── tools/-│ └── compat-harness/-└── tests/+└── 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```-## How to use+## Prerequisites++- Rust toolchain installed (`rustup`, stable toolchain)+- Network access and Anthropic credentials for live prompt/REPL usage-From this directory:+## Build++From the repository root:```bash-cargo fmt --all-cargo check --workspace-cargo test --workspace+cd rust+cargo build --release -p rusty-claude-cli+```++The optimized binary will be written to:++```bash+./target/release/rusty-claude-cli+```++## Test++Run the verified workspace test suite used for release-readiness:++```bash+cd rust+cargo test --workspace --exclude compat-harness+```++## Quick start++### Show help++```bash+cd rustcargo run -p rusty-claude-cli -- --help-cargo run -p rusty-claude-cli -- dump-manifests-cargo run -p rusty-claude-cli -- bootstrap-plan```-## Design notes+### Print version++```bash+cd rust+cargo run -p rusty-claude-cli -- --version+```++## Usage examples++### 1) Prompt mode++Send one prompt, stream the answer, then exit:++```bash+cd rust+cargo run -p rusty-claude-cli -- prompt "Summarize the architecture of this repository"+```++Use a specific model:++```bash+cd rust+cargo run -p rusty-claude-cli -- --model claude-sonnet-4-20250514 prompt "List the key crates in this workspace"+```++### 2) REPL mode++Start the interactive shell:++```bash+cd rust+cargo run -p rusty-claude-cli --+```++Inside the REPL, useful commands include:++```text+/help+/status+/model claude-sonnet-4-20250514+/permissions workspace-write+/cost+/compact+/memory+/config+/init+/exit+```++### 3) Resume an existing session++Inspect or maintain a saved session file without entering the REPL:++```bash+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:++```bash+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 session+- `dump-manifests` — print extracted upstream manifest counts+- `bootstrap-plan` — print the current bootstrap skeleton+- `system-prompt [--cwd PATH] [--date YYYY-MM-DD]` — render the synthesized system prompt+- `--help` / `-h` — show CLI help+- `--version` / `-V` — print the CLI version++### 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 starter `CLAUDE.md`+- `/exit` — leave the REPL++## Environment variables++### Anthropic/API++- `ANTHROPIC_AUTH_TOKEN` — preferred bearer token for API auth+- `ANTHROPIC_API_KEY` — legacy API key fallback if auth token is unset+- `ANTHROPIC_BASE_URL` — override the Anthropic API base URL+- `ANTHROPIC_MODEL` — default model used by selected live integration tests-The shape follows the PRD's harness-first recommendation:+### CLI/runtime-1. Extract observable upstream command/tool/bootstrap facts first.-2. Keep Rust module boundaries recognizable.-3. Grow runtime compatibility behind proof artifacts.-4. Document explicit gaps instead of implying drop-in parity too early.+- `RUSTY_CLAUDE_PERMISSION_MODE` — default REPL permission mode (`read-only`, `workspace-write`, or `danger-full-access`)+- `CLAUDE_CONFIG_HOME` — override Claude config discovery root+- `CLAUDE_CODE_REMOTE` — enable remote-session bootstrap handling when supported+- `CLAUDE_CODE_REMOTE_SESSION_ID` — remote session identifier when using remote mode+- `CLAUDE_CODE_UPSTREAM` — override the upstream TS source path for compat-harness extraction+- `CLAWD_WEB_SEARCH_BASE_URL` — override the built-in web search service endpoint used by tooling-## Relationship to the root README+## Notes-The repository root README explains the leaked TypeScript codebase. This document tracks the Rust replacement effort that lives in `rust/`.+- `compat-harness` exists 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.diff --git a/rust/crates/rusty-claude-cli/src/main.rs b/rust/crates/rusty-claude-cli/src/main.rsindex a2e242b7..350291ab 100644--- a/rust/crates/rusty-claude-cli/src/main.rs+++ b/rust/crates/rusty-claude-cli/src/main.rs@@ -26,6 +26,7 @@ use tools::{execute_tool, mvp_tool_specs};const DEFAULT_MODEL: &str = "claude-sonnet-4-20250514";const DEFAULT_MAX_TOKENS: u32 = 32;const DEFAULT_DATE: &str = "2026-03-31";+const VERSION: &str = env!("CARGO_PKG_VERSION");fn main() {if let Err(error) = run() {@@ -47,6 +48,7 @@ fn run() -> Result<(), Box<dyn std::error::Error>> {CliAction::Prompt { prompt, model } => LiveCli::new(model, false)?.run_turn(&prompt)?,CliAction::Repl { model } => run_repl(model)?,CliAction::Help => print_help(),+ CliAction::Version => print_version(),}Ok(())}@@ -71,6 +73,7 @@ enum CliAction {model: String,},Help,+ Version,}fn parse_args(args: &[String]) -> Result<CliAction, String> {@@ -104,6 +107,9 @@ fn parse_args(args: &[String]) -> Result<CliAction, String> {if matches!(rest.first().map(String::as_str), Some("--help" | "-h")) {return Ok(CliAction::Help);}+ if matches!(rest.first().map(String::as_str), Some("--version" | "-V")) {+ return Ok(CliAction::Version);+ }if rest.first().map(String::as_str) == Some("--resume") {return parse_resume_args(&rest[1..]);}@@ -1400,22 +1406,91 @@ fn convert_messages(messages: &[ConversationMessage]) -> Vec<InputMessage> {}fn print_help() {- println!("rusty-claude-cli");- println!();- println!("Usage:");- println!(" rusty-claude-cli [--model MODEL]");- println!(" Start interactive REPL");- println!(" rusty-claude-cli [--model MODEL] prompt TEXT");- println!(" Send one prompt and stream the response");- println!(" rusty-claude-cli --resume SESSION.json [/status] [/compact] [...]");- println!(" Inspect or maintain a saved session without entering the REPL");- println!(" rusty-claude-cli dump-manifests");- println!(" rusty-claude-cli bootstrap-plan");- println!(" rusty-claude-cli system-prompt [--cwd PATH] [--date YYYY-MM-DD]");- println!();- println!("Interactive slash commands:");- println!("{}", render_slash_command_help());- println!();+ let mut stdout = io::stdout();+ let _ = print_help_to(&mut stdout);+}++fn print_help_to(out: &mut impl Write) -> io::Result<()> {+ writeln!(out, "rusty-claude-cli")?;+ writeln!(out, "Version: {VERSION}")?;+ writeln!(out)?;+ writeln!(+ out,+ "Rust-first Claude Code-style CLI for prompt, REPL, and saved-session workflows."+ )?;+ writeln!(out)?;+ writeln!(out, "Usage:")?;+ writeln!(out, " rusty-claude-cli [--model MODEL]")?;+ writeln!(out, " Start interactive REPL")?;+ writeln!(out, " rusty-claude-cli [--model MODEL] prompt TEXT")?;+ writeln!(out, " Send one prompt and stream the response")?;+ writeln!(+ out,+ " rusty-claude-cli --resume SESSION.json [/status] [/compact] [...]"+ )?;+ writeln!(+ out,+ " Inspect or maintain a saved session without entering the REPL"+ )?;+ writeln!(out, " rusty-claude-cli dump-manifests")?;+ writeln!(+ out,+ " Inspect extracted upstream command/tool metadata"+ )?;+ writeln!(out, " rusty-claude-cli bootstrap-plan")?;+ writeln!(out, " Print the current bootstrap phase skeleton")?;+ writeln!(+ out,+ " rusty-claude-cli system-prompt [--cwd PATH] [--date YYYY-MM-DD]"+ )?;+ writeln!(+ out,+ " Render the synthesized system prompt for debugging"+ )?;+ writeln!(out, " rusty-claude-cli --help")?;+ writeln!(out, " rusty-claude-cli --version")?;+ writeln!(out)?;+ writeln!(out, "Options:")?;+ writeln!(+ out,+ " --model MODEL Override the active Anthropic model"+ )?;+ writeln!(+ out,+ " --resume PATH Restore a saved session file and optionally run slash commands"+ )?;+ writeln!(out, " -h, --help Show this help page")?;+ writeln!(out, " -V, --version Print the CLI version")?;+ writeln!(out)?;+ writeln!(out, "Environment:")?;+ writeln!(+ out,+ " ANTHROPIC_AUTH_TOKEN Preferred bearer token for Anthropic API requests"+ )?;+ writeln!(+ out,+ " ANTHROPIC_API_KEY Legacy API key fallback if auth token is unset"+ )?;+ writeln!(+ out,+ " ANTHROPIC_BASE_URL Override the Anthropic API base URL"+ )?;+ writeln!(+ out,+ " ANTHROPIC_MODEL Default model for selected integration tests"+ )?;+ writeln!(+ out,+ " RUSTY_CLAUDE_PERMISSION_MODE Default permission mode for REPL sessions"+ )?;+ writeln!(+ out,+ " CLAUDE_CONFIG_HOME Override Claude config discovery root"+ )?;+ writeln!(out)?;+ writeln!(out, "Interactive slash commands:")?;+ writeln!(out, "{}", render_slash_command_help())?;+ writeln!(out)?;let resume_commands = resume_supported_slash_commands().into_iter().map(|spec| match spec.argument_hint {@@ -1424,10 +1499,26 @@ fn print_help() {}).collect::<Vec<_>>().join(", ");- println!("Resume-safe commands: {resume_commands}");- println!("Examples:");- println!(" rusty-claude-cli --resume session.json /status /compact /cost");- println!(" rusty-claude-cli --resume session.json /memory /config");+ writeln!(out, "Resume-safe commands: {resume_commands}")?;+ writeln!(out, "Examples:")?;+ writeln!(+ out,+ " rusty-claude-cli prompt \"Summarize the repo architecture\""+ )?;+ writeln!(out, " rusty-claude-cli --model claude-sonnet-4-20250514")?;+ writeln!(+ out,+ " rusty-claude-cli --resume session.json /status /compact /cost"+ )?;+ writeln!(+ out,+ " rusty-claude-cli --resume session.json /memory /config"+ )?;+ Ok(())+}++fn print_version() {+ println!("rusty-claude-cli {VERSION}");}#[cfg(test)]@@ -1525,6 +1616,18 @@ mod tests {);}+ #[test]+ fn parses_version_flags() {+ assert_eq!(+ parse_args(&["--version".to_string()]).expect("args should parse"),+ CliAction::Version+ );+ assert_eq!(+ parse_args(&["-V".to_string()]).expect("args should parse"),+ CliAction::Version+ );+ }+#[test]fn shared_help_uses_resume_annotation_copy() {let help = commands::render_slash_command_help();@@ -1532,6 +1635,16 @@ mod tests {assert!(help.contains("works with --resume SESSION.json"));}+ #[test]+ fn cli_help_mentions_version_and_environment() {+ let mut output = Vec::new();+ super::print_help_to(&mut output).expect("help should render");+ let help = String::from_utf8(output).expect("help should be utf8");+ assert!(help.contains("--version"));+ assert!(help.contains("ANTHROPIC_AUTH_TOKEN"));+ assert!(help.contains("RUSTY_CLAUDE_PERMISSION_MODE"));+ }+#[test]fn repl_help_includes_shared_commands_and_exit() {let help = render_repl_help();@@ -1547,6 +1660,7 @@ mod tests {assert!(help.contains("/memory"));assert!(help.contains("/init"));assert!(help.contains("/exit"));+ assert!(help.contains("slash commands"));}#[test]