claw-code/rust/README.md

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

Login with OAuth

Configure settings.json with an oauth block containing clientId, authorizeUrl, tokenUrl, optional callbackPort, and optional scopes, then run:

cd rust
cargo run -p rusty-claude-cli -- login

This opens the browser, listens on the configured localhost callback, exchanges the auth code for tokens, and stores OAuth credentials in ~/.claude/credentials.json (or $CLAUDE_CONFIG_HOME/credentials.json).

Logout

cd rust
cargo run -p rusty-claude-cli -- logout

This removes only the stored OAuth credentials and preserves unrelated JSON fields in credentials.json.

Self-update

cd rust
cargo run -p rusty-claude-cli -- self-update

The command checks the latest GitHub release for instructkr/clawd-code, compares it to the current binary version, downloads the matching binary asset plus checksum manifest, verifies SHA-256, replaces the current executable, and prints the release changelog. If no published release or matching asset exists, it exits safely with an explanatory message.

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

Bootstrap Claude project files for the current repo:

cd rust
cargo run -p rusty-claude-cli -- init

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
/sessions
/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-123456 /status /compact /cost

You can also inspect memory/config state for a restored session:

cd rust
cargo run -p rusty-claude-cli -- --resume ~/.claude/sessions/session-123456.json /memory /config

Available commands

Top-level CLI commands

• prompt <text...> — run one prompt non-interactively
• --resume <session-id-or-path> [/commands...] — inspect or maintain a saved session stored under ~/.claude/sessions/
• 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
• self-update — update the installed binary from the latest GitHub release when a matching asset is available
• --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-id-or-path> — load a saved session into the REPL
• /config [env|hooks|model] — inspect discovered Claude config
• /memory — inspect loaded instruction memory files
• /init — bootstrap .claude.json, .claude/, CLAUDE.md, and local ignore rules
• /diff — show the current git diff for the workspace
• /version — print version and build metadata locally
• /export [file] — export the current conversation transcript
• /sessions — list recent managed local sessions from ~/.claude/sessions/
• /session [list|switch <session-id>] — inspect or switch managed local sessions
• /exit — leave the REPL

Environment variables

Anthropic/API

• ANTHROPIC_API_KEY — highest-precedence API credential
• ANTHROPIC_AUTH_TOKEN — bearer-token override used when no API key is set
• Persisted OAuth credentials in ~/.claude/credentials.json — used when neither env var is set
• ANTHROPIC_BASE_URL — override the Anthropic API base URL
• ANTHROPIC_MODEL — default model used by selected live integration tests

CLI/runtime

• 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

Notes

• 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.