claw-code

An agent-managed museum exhibit, built in Rust with Gajae-Code / LazyCodex — developed and maintained with no human intervention.

195,006 stars Rust Markdown Skills API Spec
AI Prompts & Specs

Repository: ultraworkers/claw-code


Stars: 185598

CLAUDE.md

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Detected stack


- Languages: Rust.
- Frameworks: none detected from the supported starter markers.

Verification


- Run Rust verification from rust/: cargo fmt, cargo clippy --workspace --all-targets -- -D warnings, cargo test --workspace
- src/ and tests/ are both present; update both surfaces together when behavior changes.

Repository shape


- rust/ contains the Rust workspace and active CLI/runtime implementation.
- src/ contains source files that should stay consistent with generated guidance and tests.
- tests/ contains validation surfaces that should be reviewed alongside code changes.

Working agreement


- Prefer small, reviewable changes and keep generated bootstrap files aligned with actual repo workflows.
- Keep shared defaults in .claude.json; reserve .claude/settings.local.json for machine-local overrides.
- Do not overwrite existing CLAUDE.md content automatically; update it intentionally when repo workflows change.


README.md

Claw Code

<p align="center">
<a href="https://github.com/ultraworkers/claw-code">ultraworkers/claw-code</a>
·
<a href="./USAGE.md">Usage</a>
·
<a href="./rust/README.md">Rust workspace</a>
·
<a href="./PARITY.md">Parity</a>
·
<a href="./ROADMAP.md">Roadmap</a>
·
<a href="https://discord.gg/5TUQKqFWd">UltraWorkers Discord</a>
</p>

<p align="center">
<a href="https://star-history.com/#ultraworkers/claw-code&Date">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=ultraworkers/claw-code&type=Date&theme=dark" />
<source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=ultraworkers/claw-code&type=Date" />
<img alt="Star history for ultraworkers/claw-code" src="https://api.star-history.com/svg?repos=ultraworkers/claw-code&type=Date" width="600" />
</picture>
</a>
</p>

<p align="center">
<img src="assets/claw-hero.jpeg" alt="Claw Code" width="300" />
</p>

Claw Code is the public Rust implementation of the claw CLI agent harness.
The canonical implementation lives in rust/, and the current source of truth for this repository is ultraworkers/claw-code.

IMPORTANT

Start with USAGE.md for build, auth, CLI, session, and parity-harness workflows. Make claw doctor your first health check after building, use rust/README.md for crate-level details, read PARITY.md for the current Rust-port checkpoint, and see docs/container.md for the container-first workflow.


> ACP / Zed status: claw-code does not ship an ACP/Zed daemon entrypoint yet. Run claw acp (or claw --acp) for the current status instead of guessing from source layout; claw acp serve is currently a discoverability alias only, and real ACP support remains tracked separately in ROADMAP.md.

Current repository shape

- rust/ — canonical Rust workspace and the claw CLI binary
- USAGE.md — task-oriented usage guide for the current product surface
- PARITY.md — Rust-port parity status and migration notes
- ROADMAP.md — active roadmap and cleanup backlog
- PHILOSOPHY.md — project intent and system-design framing
- src/ + tests/ — companion Python/reference workspace and audit helpers; not the primary runtime surface

Quick start

NOTE

[!WARNING]


cargo install claw-code installs the wrong thing. The claw-code crate on crates.io is a deprecated stub that places claw-code-deprecated.exe — not claw. Running it only prints "claw-code has been renamed to agent-code". Do not use cargo install claw-code. Either build from source (this repo) or install the upstream binary:

``bash

cargo install agent-code # upstream binary — installs 'agent.exe' (Windows) / 'agent' (Unix), NOT 'agent-code'

`

This repo (ultraworkers/claw-code) is build-from-source only — follow the steps below.

bash
1. Clone and build

git clone https://github.com/ultraworkers/claw-code
cd claw-code/rust
cargo build --workspace
2. Set your API key (Anthropic API key — not a Claude subscription)

export ANTHROPIC_API_KEY="sk-ant-..."
3. Verify everything is wired correctly

./target/debug/claw doctor
4. Run a prompt

./target/debug/claw prompt "say hello"

NOTE

Windows (PowerShell): the binary is claw.exe, not claw. Use .\target\debug\claw.exe or run cargo run -- prompt "say hello" to skip the path lookup.

Windows setup

PowerShell is a supported Windows path. Use whichever shell works for you. The common onboarding issues on Windows are:

1. Install Rust first — download from <https://rustup.rs/> and run the installer. Close and reopen your terminal when it finishes.
2. Verify Rust is on PATH:

powershell
cargo --version

If this fails, reopen your terminal or run the PATH setup from the Rust installer output, then retry.
3. Clone and build (works in PowerShell, Git Bash, or WSL):
powershell
git clone https://github.com/ultraworkers/claw-code
   cd claw-code/rust
   cargo build --workspace

4. Run (PowerShell — note .exe and backslash):
powershell
$env:ANTHROPIC_API_KEY = "sk-ant-..."
   .\target\debug\claw.exe prompt "say hello"

Git Bash / WSL are optional alternatives, not requirements. If you prefer bash-style paths (/c/Users/you/... instead of C:\Users\you\...), Git Bash (ships with Git for Windows) works well. In Git Bash, the MINGW64 prompt is expected and normal — not a broken install.

NOTE

Auth: claw requires an API key (ANTHROPIC_API_KEY, OPENAI_API_KEY, etc.) — Claude subscription login is not a supported auth path.

Run the workspace test suite:

bash
cd rust
cargo test --workspace

Documentation map

- USAGE.md — quick commands, auth, sessions, config, parity harness
- rust/README.md — crate map, CLI surface, features, workspace layout
- PARITY.md — parity status for the Rust port
- rust/MOCK_PARITY_HARNESS.md — deterministic mock-service harness details
- ROADMAP.md — active roadmap and open cleanup work
- PHILOSOPHY.md` — why the project exists and how it is operated

Ecosystem

Claw Code is built in the open alongside the broader UltraWorkers toolchain:

- clawhip
- oh-my-openagent
- oh-my-claudecode
- oh-my-codex
- UltraWorkers Discord

Ownership / affiliation disclaimer

- This repository does not claim ownership of the original Claude Code source material.
- This repository is not affiliated with, endorsed by, or maintained by Anthropic.