explaingit

ultraworkers/claw-code

190,377RustAudience · developerComplexity · 3/5LicenseSetup · moderate

TLDR

Open-source Rust CLI tool that runs an AI coding agent in your terminal, letting you send prompts and commands to Claude via API.

Mindmap

mindmap
  root((claw-code))
    What it does
      AI agent harness
      Terminal CLI tool
      Rust implementation
    How to use
      Set API key
      Build from source
      Run claw commands
    Key commands
      claw doctor
      claw prompt
    Setup
      macOS Linux Windows
      Cargo build
      PATH installation
    Documentation
      USAGE.md
      PARITY.md
      ROADMAP.md
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Build and run an AI coding agent locally in your terminal to automate coding tasks.

USE CASE 2

Study the open-source Rust implementation of an agent harness and contribute improvements.

USE CASE 3

Integrate Claude API access into your development workflow via command-line interface.

Tech stack

RustCargoAnthropic API

Getting it running

Difficulty · moderate Time to first run · 30min

Requires Anthropic API key and Rust/Cargo installation.

Use freely for any purpose including commercial, as long as you keep the copyright notice.

In plain English

Claw Code is, according to its README, "the public Rust implementation of the claw CLI agent harness." A CLI agent harness here is a command-line tool that talks to an AI model and lets the model take actions on your machine, the README's quick start shows commands like claw prompt "say hello" and a claw doctor health check. The canonical source lives in the rust/ workspace inside this repo, and the project description calls it "the fastest repo in history to surpass 100K stars." The way it works is that you clone the repo, run cargo build --workspace inside rust/, and then run the resulting claw binary, having first set an API key in the environment. The README explicitly says claw requires an API key (it lists ANTHROPIC_API_KEY and OPENAI_API_KEY as examples), a Claude subscription login is not a supported auth path. After building, the binary lives at rust/target/debug/claw (or claw.exe on Windows), there are instructions for symlinking it onto PATH, using cargo install --path ., or editing your shell profile. A separate test suite runs via cargo test --workspace. The README also warns that cargo install claw-code from crates.io is a deprecated stub and should not be used, the upstream binary is installed via cargo install agent-code instead. Someone would use this when they want to run a local AI coding agent from the command line and prefer the Rust build of the harness, or when they want to read and modify the harness source themselves. The repo also contains companion documentation files (USAGE.md, PARITY.md, ROADMAP.md, PHILOSOPHY.md, container.md) and a Python reference workspace.

Copy-paste prompts

Prompt 1
I want to set up claw-code on my machine. Walk me through cloning the repo, building it with cargo, setting my ANTHROPIC_API_KEY, and running claw doctor to verify everything works.
Prompt 2
Show me how to use claw prompt to send a coding task to the AI agent and what the output looks like.
Prompt 3
I'm interested in contributing to claw-code. What does PARITY.md tell me about the Rust port status, and what's on the ROADMAP.md?
Prompt 4
How do I install the claw binary to my PATH after building it so I can run it from anywhere in my terminal?
Open on GitHub → Explain another repo

This repo across BitVibe Labs

Scan in gitsafehub Deploy in gitdeployhub ultraworkers on gitmyhub

Verify against the repo before relying on details.