mirror of
https://github.com/instructkr/claw-code.git
synced 2026-04-07 00:24:50 +08:00
af75a23be2
Add a checked-in Containerfile plus container-first documentation so Docker and Podman users have a canonical image build, bind-mount, and cargo test entrypoint. The README now links directly to the new guide. Constraint: The repo already had runtime container detection but no checked-in Dockerfile, Containerfile, or devcontainer config Rejected: Put all container steps inline in README only | harder to maintain and less reusable than a dedicated guide plus Containerfile Confidence: high Scope-risk: narrow Reversibility: clean Directive: Keep docs/container.md and Containerfile aligned whenever Rust workspace prerequisites change Tested: docker build -t claw-code-dev-docs-verify -f Containerfile . Tested: cargo test --workspace (host, in rust/) Not-tested: Podman commands were documented but not executed in this environment Not-tested: Repeated in-container cargo test --workspace currently trips crates/tools PowerShell stub detection on this minimal image even though host cargo test passes
186 lines
7.8 KiB
Markdown
186 lines
7.8 KiB
Markdown
# Rewriting Project Claw Code
|
|
|
|
<p align="center">
|
|
<strong>⭐ The fastest repo in history to surpass 50K stars, reaching the milestone in just 2 hours after publication ⭐</strong>
|
|
</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 Chart" src="https://api.star-history.com/svg?repos=ultraworkers/claw-code&type=Date" width="600" />
|
|
</picture>
|
|
</a>
|
|
</p>
|
|
|
|
<p align="center">
|
|
<img src="assets/clawd-hero.jpeg" alt="Claw" width="300" />
|
|
</p>
|
|
|
|
<p align="center">
|
|
<strong>Autonomously maintained by lobsters/claws — not by human hands</strong>
|
|
</p>
|
|
|
|
<p align="center">
|
|
<a href="https://github.com/Yeachan-Heo/clawhip">clawhip</a> ·
|
|
<a href="https://github.com/code-yeongyu/oh-my-openagent">oh-my-openagent</a> ·
|
|
<a href="https://github.com/Yeachan-Heo/oh-my-claudecode">oh-my-claudecode</a> ·
|
|
<a href="https://github.com/Yeachan-Heo/oh-my-codex">oh-my-codex</a> ·
|
|
<a href="https://discord.gg/6ztZB9jvWq">UltraWorkers Discord</a>
|
|
</p>
|
|
|
|
> [!IMPORTANT]
|
|
> The active Rust workspace now lives in [`rust/`](./rust). Start with [`USAGE.md`](./USAGE.md) for build, auth, CLI, session, and parity-harness workflows, use [`rust/README.md`](./rust/README.md) for crate-level details, and see [`docs/container.md`](./docs/container.md) for Docker/Podman container-first usage.
|
|
|
|
> Want the bigger idea behind this repo? Read [`PHILOSOPHY.md`](./PHILOSOPHY.md) and Sigrid Jin's public explanation: https://x.com/realsigridjin/status/2039472968624185713
|
|
|
|
> Shout-out to the UltraWorkers ecosystem powering this repo: [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), and the [UltraWorkers Discord](https://discord.gg/6ztZB9jvWq).
|
|
|
|
---
|
|
|
|
## Backstory
|
|
|
|
This repo is maintained by **lobsters/claws**, not by a conventional human-only dev team.
|
|
|
|
The people behind the system are [Bellman / Yeachan Heo](https://github.com/Yeachan-Heo) and friends like [Yeongyu](https://github.com/code-yeongyu), but the repo itself is being pushed forward by autonomous claw workflows: parallel coding sessions, event-driven orchestration, recovery loops, and machine-readable lane state.
|
|
|
|
In practice, that means this project is not just *about* coding agents — it is being **actively built by them**. Features, tests, telemetry, docs, and workflow hardening are landed through claw-driven loops using [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), and [oh-my-codex](https://github.com/Yeachan-Heo/oh-my-codex).
|
|
|
|
This repository exists to prove that an open coding harness can be built **autonomously, in public, and at high velocity** — with humans setting direction and claws doing the grinding.
|
|
|
|
See the public build story here:
|
|
|
|
https://x.com/realsigridjin/status/2039472968624185713
|
|
|
|
|
|
|
|
---
|
|
|
|
## Porting Status
|
|
|
|
The main source tree is now Python-first.
|
|
|
|
- `src/` contains the active Python porting workspace
|
|
- `tests/` verifies the current Python workspace
|
|
- the exposed snapshot is no longer part of the tracked repository state
|
|
|
|
The current Python workspace is not yet a complete one-to-one replacement for the original system, but the primary implementation surface is now Python.
|
|
|
|
## Why this rewrite exists
|
|
|
|
I originally studied the exposed codebase to understand its harness, tool wiring, and agent workflow. After spending more time with the legal and ethical questions—and after reading the essay linked below—I did not want the exposed snapshot itself to remain the main tracked source tree.
|
|
|
|
This repository now focuses on Python porting work instead.
|
|
|
|
## Repository Layout
|
|
|
|
```text
|
|
.
|
|
├── src/ # Python porting workspace
|
|
│ ├── __init__.py
|
|
│ ├── commands.py
|
|
│ ├── main.py
|
|
│ ├── models.py
|
|
│ ├── port_manifest.py
|
|
│ ├── query_engine.py
|
|
│ ├── task.py
|
|
│ └── tools.py
|
|
├── tests/ # Python verification
|
|
├── assets/omx/ # OmX workflow screenshots
|
|
├── 2026-03-09-is-legal-the-same-as-legitimate-ai-reimplementation-and-the-erosion-of-copyleft.md
|
|
└── README.md
|
|
```
|
|
|
|
## Python Workspace Overview
|
|
|
|
The new Python `src/` tree currently provides:
|
|
|
|
- **`port_manifest.py`** — summarizes the current Python workspace structure
|
|
- **`models.py`** — dataclasses for subsystems, modules, and backlog state
|
|
- **`commands.py`** — Python-side command port metadata
|
|
- **`tools.py`** — Python-side tool port metadata
|
|
- **`query_engine.py`** — renders a Python porting summary from the active workspace
|
|
- **`main.py`** — a CLI entrypoint for manifest and summary output
|
|
|
|
## Quickstart
|
|
|
|
Render the Python porting summary:
|
|
|
|
```bash
|
|
python3 -m src.main summary
|
|
```
|
|
|
|
Print the current Python workspace manifest:
|
|
|
|
```bash
|
|
python3 -m src.main manifest
|
|
```
|
|
|
|
List the current Python modules:
|
|
|
|
```bash
|
|
python3 -m src.main subsystems --limit 16
|
|
```
|
|
|
|
Run verification:
|
|
|
|
```bash
|
|
python3 -m unittest discover -s tests -v
|
|
```
|
|
|
|
Run the parity audit against the local ignored archive (when present):
|
|
|
|
```bash
|
|
python3 -m src.main parity-audit
|
|
```
|
|
|
|
Inspect mirrored command/tool inventories:
|
|
|
|
```bash
|
|
python3 -m src.main commands --limit 10
|
|
python3 -m src.main tools --limit 10
|
|
```
|
|
|
|
## Current Parity Checkpoint
|
|
|
|
The port now mirrors the archived root-entry file surface, top-level subsystem names, and command/tool inventories much more closely than before. However, it is **not yet** a full runtime-equivalent replacement for the original TypeScript system; the Python tree still contains fewer executable runtime slices than the archived source.
|
|
|
|
|
|
## Built with `oh-my-codex`
|
|
|
|
The restructuring and documentation work on this repository was AI-assisted and orchestrated with Yeachan Heo's [oh-my-codex (OmX)](https://github.com/Yeachan-Heo/oh-my-codex), layered on top of Codex.
|
|
|
|
- **`$team` mode:** used for coordinated parallel review and architectural feedback
|
|
- **`$ralph` mode:** used for persistent execution, verification, and completion discipline
|
|
- **Codex-driven workflow:** used to turn the main `src/` tree into a Python-first porting workspace
|
|
|
|
### OmX workflow screenshots
|
|
|
|
|
|
|
|
*Ralph/team orchestration view while the README and essay context were being reviewed in terminal panes.*
|
|
|
|
|
|
|
|
*Split-pane review and verification flow during the final README wording pass.*
|
|
|
|
## Community
|
|
|
|
<p align="center">
|
|
<a href="https://discord.gg/6ztZB9jvWq"><img src="https://img.shields.io/badge/UltraWorkers-Discord-5865F2?logo=discord&style=for-the-badge" alt="UltraWorkers Discord" /></a>
|
|
</p>
|
|
|
|
Join the [**UltraWorkers Discord**](https://discord.gg/6ztZB9jvWq) — the community around clawhip, oh-my-openagent, oh-my-claudecode, oh-my-codex, and claw-code. Come chat about LLMs, harness engineering, agent workflows, and autonomous software development.
|
|
|
|
[](https://discord.gg/6ztZB9jvWq)
|
|
|
|
## Star History
|
|
|
|
See the chart at the top of this README.
|
|
|
|
## 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**.
|