ultraworkers/claw-code

Claw Code – Rust‑based CLI harness for AI agents

What it is – claw-code is the public Rust implementation of the claw command‑line agent harness. It provides a binary (claw) that can talk to LLM providers (Anthropic, OpenAI, local Ollama‑style servers) and run agent‑style prompts, sessions and tool‑calling workflows. The repo contains the Rust workspace (rust/), a small Python reference layer, and extensive docs for building, configuring, and using the CLI.

Key features (as described in the README)

• Agent‑managed CLI – the harness plans, executes, verifies and labels work automatically; it is meant to be run by other agents rather than hand‑operated.
• Multi‑provider support – works with Anthropic, OpenAI and local OpenAI‑compatible servers (Ollama, vLLM, etc.).
• Interactive and one‑off modes – claw prompt "…" for a single request, claw for an interactive REPL‑style session.
• Health‑check command – claw doctor validates API keys, model access and tool configuration.
• Parity harness – a mock service (MOCK_PARITY_HARNESS.md) for deterministic testing and migration tracking.
• Container‑first workflow – docs describe running the harness inside containers.
• Future ACP/Zed JSON‑RPC – roadmap mentions adding an ACP daemon and JSON‑RPC entry‑point.

How to get started

1. Clone & build the Rust workspace:

   git clone https://github.com/ultraworkers/claw-code
   cd claw-code/rust
   cargo build --workspace   # or `cargo build --release`
   

2. Set an API key (e.g. Anthropic):

   export ANTHROPIC_API_KEY="sk-ant-..."
   

3. Run the health check:

   ./target/debug/claw doctor
   

4. Try a prompt:

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

5. Enter interactive mode:

   ./target/debug/claw
   

Windows users follow the same steps in PowerShell, using claw.exe.

Documentation map – the repo ships a collection of markdown files:

• USAGE.md – quick‑start commands, auth, sessions, parity harness.
• rust/README.md – crate layout and CLI surface.
• docs/ – provider setup, container workflow, Windows install, event/report contracts, etc.
• PARITY.md, ROADMAP.md, PHILOSOPHY.md – project status, future plans, and design rationale.

Ecosystem – claw sits alongside other UltraWorkers tools such as clawhip, oh‑my‑openagent, gajae-code, etc., and the community gathers on two Discord servers.

License – MIT.

Bottom line – If you need a Rust‑native CLI to run LLM‑backed autonomous agents, manage sessions, and experiment with multi‑provider setups, claw-code provides that harness. It is a build‑from‑source only project; the published claw-code crate on crates.io is a deprecated stub, so you must compile the binary yourself or install the upstream agent-code package.