Claw Code

Claw Code is a local coding-agent project centered on the Rust claw CLI under rust/.

This repository currently contains:

• rust/: the active Rust implementation
• src/: a Python porting and parity workspace
• tests/: Python-side workspace verification

Claw Code is inspired by local agent tooling patterns and developed as a clean-room implementation. It is intended to be a standalone open-source project, not a redistribution of any proprietary source tree.

Status

• Primary implementation: Rust
• Distribution model: source build
• Platform focus: macOS and Linux developer workstations
• Repository stage: early public release

Repository layout

.
├── rust/                               # Active Rust implementation
│   ├── crates/claw-cli/                # CLI binary
│   ├── crates/api/                     # Provider clients and streaming
│   ├── crates/runtime/                 # Sessions, permissions, prompts, MCP
│   ├── crates/tools/                   # Built-in tools
│   ├── crates/commands/                # Slash commands
│   ├── crates/plugins/                 # Plugin system
│   ├── crates/lsp/                     # LSP support
│   ├── crates/server/                  # HTTP/SSE support
│   └── crates/compat-harness/          # Compatibility helpers
├── src/                                # Python parity and manifest workspace
├── tests/                              # Python workspace verification
├── CLAW.md                             # Project workflow guidance
├── PARITY.md                           # Porting and parity notes
└── README.md

Quick start

Build the Rust CLI:

cd rust
cargo build --release -p claw-cli

Run the CLI:

cd rust
cargo run --bin claw -- --help
cargo run --bin claw --
cargo run --bin claw -- prompt "summarize this workspace"

Run the Rust test suite:

cd rust
cargo test --workspace

Run the Python workspace checks:

python3 -m unittest discover -s tests -v

Authentication

Claw Code currently supports provider credentials through environment variables.

Anthropic-compatible endpoints:

export ANTHROPIC_API_KEY="..."
export ANTHROPIC_BASE_URL="https://api.anthropic.com"

OpenAI-compatible endpoints:

export OPENAI_API_KEY="..."
export OPENAI_BASE_URL="https://example.com/v1"

xAI-compatible endpoints:

export XAI_API_KEY="..."
export XAI_BASE_URL="https://api.x.ai"

OAuth login is also available from the Rust CLI:

cd rust
cargo run --bin claw -- login

Documentation

• Rust implementation overview: rust/README.md
• Contribution guide: rust/CONTRIBUTING.md
• Workflow guidance: CLAW.md
• Porting notes: PARITY.md
• Security policy: SECURITY.md

Security

If you discover a security issue, do not open a public issue with a live exploit. Follow the reporting instructions in SECURITY.md.

License

This repository is licensed under the Apache License 2.0. See LICENSE.