mirror of
https://github.com/instructkr/claw-code.git
synced 2026-04-06 16:14:49 +08:00
163cf00650
Finish the remaining roadmap work by making direct CLI JSON output deterministic across the non-interactive surface, restoring the degraded-startup MCP test as a real workspace test, and adding branch-lock plus commit-lineage primitives so downstream lane consumers can distinguish superseded worktree commits from canonical lineage. Constraint: Keep the user-facing config namespace centered on .claw while preserving legacy fallback discovery for compatibility Constraint: Verification needed to stay clean-room and reproducible from the checked-in workspace alone Rejected: Leave the output-format contract implied by ad-hoc smoke runs only | too easy for direct CLI regressions to slip back into prose-only output Rejected: Keep commit provenance as free-form detail text | downstream consumers need structured branch/worktree/supersession metadata Confidence: medium Scope-risk: moderate Directive: Extend the JSON contract through the same direct CLI entrypoints instead of adding one-off serializers on parallel code paths Tested: python .github/scripts/check_doc_source_of_truth.py Tested: cd rust && cargo fmt --all --check Tested: cd rust && cargo test --workspace Tested: cd rust && cargo clippy -p commands -p tools -p rusty-claude-cli --all-targets --no-deps -- -D warnings Not-tested: full cargo clippy --workspace --all-targets -- -D warnings still reports unrelated pre-existing runtime lint debt outside this change set
94 lines
3.6 KiB
Markdown
94 lines
3.6 KiB
Markdown
# 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/`](./rust), and the current source of truth for this repository is **ultraworkers/claw-code**.
|
|
|
|
> [!IMPORTANT]
|
|
> Start with [`USAGE.md`](./USAGE.md) for build, auth, CLI, session, and parity-harness workflows. Make `claw doctor` your first health check after building, use [`rust/README.md`](./rust/README.md) for crate-level details, read [`PARITY.md`](./PARITY.md) for the current Rust-port checkpoint, and see [`docs/container.md`](./docs/container.md) for the container-first workflow.
|
|
|
|
## 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
|
|
|
|
```bash
|
|
cd rust
|
|
cargo build --workspace
|
|
./target/debug/claw --help
|
|
./target/debug/claw prompt "summarize this repository"
|
|
```
|
|
|
|
Authenticate with either an API key or the built-in OAuth flow:
|
|
|
|
```bash
|
|
export ANTHROPIC_API_KEY="sk-ant-..."
|
|
# or
|
|
cd rust
|
|
./target/debug/claw login
|
|
```
|
|
|
|
Run the workspace test suite:
|
|
|
|
```bash
|
|
cd rust
|
|
cargo test --workspace
|
|
```
|
|
|
|
## Documentation map
|
|
|
|
- [`USAGE.md`](./USAGE.md) — quick commands, auth, sessions, config, parity harness
|
|
- [`rust/README.md`](./rust/README.md) — crate map, CLI surface, features, workspace layout
|
|
- [`PARITY.md`](./PARITY.md) — parity status for the Rust port
|
|
- [`rust/MOCK_PARITY_HARNESS.md`](./rust/MOCK_PARITY_HARNESS.md) — deterministic mock-service harness details
|
|
- [`ROADMAP.md`](./ROADMAP.md) — active roadmap and open cleanup work
|
|
- [`PHILOSOPHY.md`](./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](https://github.com/Yeachan-Heo/clawhip)
|
|
- [oh-my-openagent](https://github.com/code-yeongyu/oh-my-openagent)
|
|
- [oh-my-claudecode](https://github.com/Yeachan-Heo/oh-my-claudecode)
|
|
- [oh-my-codex](https://github.com/Yeachan-Heo/oh-my-codex)
|
|
- [UltraWorkers Discord](https://discord.gg/5TUQKqFWd)
|
|
|
|
## 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**.
|