claw-code

Claw Code is the public Rust implementation of the `claw` CLI agent harness. The canonical implementation lives in the `rust/` workspace, and the maintainers state that the current source of truth for the repository is `ultraworkers/claw-code`. An important framing note in the README: the project describes itself as "closer to a museum exhibit than a product pitch" and explicitly says it is "not the serious production project here." It is presented as an agent-managed artifact, maintained automatically by harnesses such as Gajae-Code and LazyCodex. For actual work, the README directs users to start with those upstream harnesses rather than this repository. A longer public explanation is linked via an X/Twitter post. The repository structure includes: - `rust/` — the canonical Rust workspace and the `claw` CLI binary - `USAGE.md` — task-oriented usage guide - `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/` and `tests/` — companion Python/reference workspace and audit helpers, described as not the primary runtime surface For building and running, the README gives a source-only quick start: clone the repo, run `cargo build --workspace` inside `rust/`, set an API key such as `ANTHROPIC_API_KEY`, then verify with `claw doctor` and run prompts with `claw prompt "..."` or start an interactive session with `claw`. On Windows the binary is `claw.exe`, and PowerShell is a supported path. Git Bash and WSL are optional alternatives. The README contains a prominent warning: `cargo install claw-code` installs a deprecated stub that only prints "claw-code has been renamed to agent-code". Users are told not to install that crate and instead build from source or install the upstream binary via `cargo install agent-code`. Authentication requires an API key (Anthropic, OpenAI, etc.); a Claude subscription login is not a supported auth path. After building, `claw doctor` is the recommended health check for validating API key, model access, and tool configuration. The workspace test suite can be run with `cargo test --workspace`. Documentation is mapped out for navigation and file context, local OpenAI-compatible providers (Ollama/llama.cpp/vLLM), Windows install and release workflows, container workflows, and the ACP/Zed status. The README notes that `claw-code` does not ship an ACP/Zed daemon or JSON-RPC entrypoint yet; `claw acp` reports current status, and real ACP support remains tracked in the roadmap. The repository also lists related ecosystem projects such as clawhip, oh-my-openagent, oh-my-claudecode, oh-my-codex, and gajae-code, plus UltraWorkers Discord links. It includes contribution, security, support, and code-of-conduct policies, and is licensed under the MIT license. The README includes an ownership/affiliation disclaimer stating that the repository does not claim ownership of original Claude Code source material and is not affiliated with, endorsed by, or maintained by Anthropic.