The claw-code repository is the public Rust implementation of the claw CLI agent harness README.md31 It is a high-performance, safe, and native tool-execution environment designed to turn LLMs into autonomous coding agents rust/README.md1-4
The project is built around the "clawable" philosophy: creating a harness that is deterministic, machine-readable, and recoverable without human intervention ROADMAP.md16-26 It moves beyond "human-first" terminal assumptions to an event-native architecture where agents (claws) are orchestrated through structured hooks, sessions, and lifecycle states ROADMAP.md7-14
Claw Code is a core component of the UltraWorkers toolchain, working alongside other autonomous development tools README.md80-89:
The following diagram bridges user intent and terminal interaction to the core Rust entities that drive the autonomous loop.
Intent to Execution Mapping
Sources: rust/README.md180-193 rust/crates/runtime/src/lib.rs1-50 rust/crates/tools/src/lib.rs1-100
The repository is organized as a Rust workspace with specialized crates rust/README.md195-204:
| Component | Description | Reference |
|---|---|---|
CLI (claw) | The main entry point handling the REPL, argument parsing, and terminal rendering. | rust/crates/rusty-claude-cli |
| Runtime | The "brain" of the system; manages the conversation loop, permissions, and MCP lifecycle. | rust/crates/runtime |
| API | Provider-agnostic client layer for Anthropic and OpenAI-compatible models. | rust/crates/api |
| Tools | Implementation of built-in tools (bash, edit, grep) and agent orchestration. | rust/crates/tools |
| Plugins | Extensibility layer for local and remote hooks/tools. | rust/crates/plugins |
The project follows a State Machine First approach. Every worker transitions through explicit lifecycle states to ensure reliability ROADMAP.md65-72
Worker Lifecycle State Machine
Sources: ROADMAP.md77-87 rust/crates/tools/src/lane_completion.rs23-66
Detailed documentation is split into the following sections:
Covers how to build the workspace using cargo build --workspace, authenticate via claw login or API keys, and perform initial health checks with claw doctor rust/README.md7-42
Deep dive into the "clawable" roadmap, the failure taxonomy (Infra vs. Code), and the Green-ness contract used to verify autonomous progress ROADMAP.md1-212
Sources:
Refresh this wiki
This wiki was recently refreshed. Please wait 4 days to refresh again.