kudzues/claw-code
1
0
Fork 0
mirror of https://github.com/instructkr/claw-code.git synced 2026-04-04 23:29:05 +08:00
Code Issues Packages Projects Releases Wiki Activity
Files
fix/ui-parity
claw-code/rust
History
Yeachan-Heo b8d78c9a53 feat: add honest plugin inspection reporting 
Shift the Rust parity increment away from implying TS-style plugin UX and toward an honest inspection surface. /plugin now reports current local plugin support, checked directories, and missing runtime wiring, while /reload-plugins rebuilds the runtime and prints the same inspection snapshot.\n\nConstraint: Rust only supports local manifest-backed plugins today; marketplace/discovery parity does not exist\nRejected: Stub marketplace installer flow | would overstate current capability\nRejected: Keep /plugin as list-only output | hides important gaps and checked paths\nConfidence: high\nScope-risk: narrow\nReversibility: clean\nDirective: Keep plugin reporting aligned with actual runtime wiring; do not advertise manifest commands/hooks as active until the runtime uses them\nTested: cargo test -p commands\nTested: cargo test -p claw-cli\nNot-tested: cargo clippy -p commands -p claw-cli --tests -- -D warnings (blocked by pre-existing workspace warnings in commands/claw-cli/lsp)
2026-04-02 00:04:23 +00:00
..
.github/workflows
ci: Rust workspace GitHub Actions (check, test, release build)
2026-04-01 20:36:48 +09:00
crates
feat: add honest plugin inspection reporting
2026-04-02 00:04:23 +00:00
docs/releases
Present Claw Code as the current Rust product
2026-04-01 17:19:09 +00:00
.gitignore
docs: README, CI workflow, CLAW.md guidance, assets, and contributing guide
2026-04-01 20:36:39 +09:00
Cargo.lock
feat: LSP client integration with diagnostics, definitions, and references
2026-04-01 21:34:58 +09:00
Cargo.toml
feat: LSP client integration with diagnostics, definitions, and references
2026-04-01 21:34:58 +09:00
CONTRIBUTING.md
docs: README, CI workflow, CLAW.md guidance, assets, and contributing guide
2026-04-01 20:36:39 +09:00
README.md
Present Claw Code as the current Rust product
2026-04-01 17:19:09 +00:00

README.md

Claw Code

Claw Code is a local coding-agent CLI implemented in safe Rust. It is Claude Code inspired and developed as a clean-room implementation: it aims for a strong local agent experience, but it is not a direct port or copy of Claude Code.

The Rust workspace is the current main product surface. The claw binary provides interactive sessions, one-shot prompts, workspace-aware tools, local agent workflows, and plugin-capable operation from a single workspace.

Current status

  • Version: 0.1.0
  • Release stage: initial public release, source-build distribution
  • Primary implementation: Rust workspace in this repository
  • Platform focus: macOS and Linux developer workstations

Install, build, and run

Prerequisites

  • Rust stable toolchain
  • Cargo
  • Provider credentials for the model you want to use

Authentication

Anthropic-compatible models:

export ANTHROPIC_API_KEY="..."
# Optional when using a compatible endpoint
export ANTHROPIC_BASE_URL="https://api.anthropic.com"

Grok models:

export XAI_API_KEY="..."
# Optional when using a compatible endpoint
export XAI_BASE_URL="https://api.x.ai"

OAuth login is also available:

cargo run --bin claw -- login

Install locally

cargo install --path crates/claw-cli --locked

Build from source

cargo build --release -p claw-cli

Run

From the workspace:

cargo run --bin claw -- --help
cargo run --bin claw --
cargo run --bin claw -- prompt "summarize this workspace"
cargo run --bin claw -- --model sonnet "review the latest changes"

From the release build:

./target/release/claw
./target/release/claw prompt "explain crates/runtime"

Supported capabilities

  • Interactive REPL and one-shot prompt execution
  • Saved-session inspection and resume flows
  • Built-in workspace tools for shell, file read/write/edit, search, web fetch/search, todos, and notebook updates
  • Slash commands for status, compaction, config inspection, diff, export, session management, and version reporting
  • Local agent and skill discovery with claw agents and claw skills
  • Plugin discovery and management through the CLI and slash-command surfaces
  • OAuth login/logout plus model/provider selection from the command line
  • Workspace-aware instruction/config loading (CLAW.md, config files, permissions, plugin settings)

Current limitations

  • Public distribution is source-build only today; this workspace is not set up for crates.io publishing
  • GitHub CI verifies cargo check, cargo test, and release builds, but automated release packaging is not yet present
  • Current CI targets Ubuntu and macOS; Windows release readiness is still to be established
  • Some live-provider integration coverage is opt-in because it requires external credentials and network access
  • The command surface may continue to evolve during the 0.x series

Implementation

The Rust workspace is the active product implementation. It currently includes these crates:

  • claw-cli — user-facing binary
  • api — provider clients and streaming
  • runtime — sessions, config, permissions, prompts, and runtime loop
  • tools — built-in tool implementations
  • commands — slash-command registry and handlers
  • plugins — plugin discovery, registry, and lifecycle support
  • lsp — language-server protocol support types and process helpers
  • server and compat-harness — supporting services and compatibility tooling

Roadmap

  • Publish packaged release artifacts for public installs
  • Add a repeatable release workflow and longer-lived changelog discipline
  • Expand platform verification beyond the current CI matrix
  • Add more task-focused examples and operator documentation
  • Continue tightening feature coverage and UX polish across the Rust implementation

Release notes

License

See the repository root for licensing details.