mirror of
https://github.com/instructkr/claw-code.git
synced 2026-04-06 08:04:50 +08:00
fa81684707
Replace the Wall Street Journal feature block in the README with a Related Projects section that points readers to the surrounding harness-engineering tooling. Keep the project cards focused on OmX, OmC, clawhip, and OmO, and tighten the surrounding copy for clarity.\n\nConstraint: This follow-up is README-only and must not include unrelated workspace edits\nRejected: Restore the WSJ feature section | owner requested it remain removed\nRejected: Expand the section into a longer narrative | weaker scannability than concise project cards\nConfidence: high\nScope-risk: narrow\nReversibility: clean\nDirective: Keep this section concise and ecosystem-oriented; avoid reintroducing unrelated press/profile copy here\nTested: Manual README diff review\nNot-tested: Rendered GitHub markdown preview
262 lines
12 KiB
Markdown
262 lines
12 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/#instructkr/claw-code&Date">
|
|
<picture>
|
|
<source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=instructkr/claw-code&type=Date&theme=dark" />
|
|
<source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=instructkr/claw-code&type=Date" />
|
|
<img alt="Star History Chart" src="https://api.star-history.com/svg?repos=instructkr/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>Better Harness Tools, not merely storing the archive of leaked Claw Code</strong>
|
|
</p>
|
|
|
|
<p align="center">
|
|
<a href="https://github.com/sponsors/instructkr"><img src="https://img.shields.io/badge/Sponsor-%E2%9D%A4-pink?logo=github&style=for-the-badge" alt="Sponsor on GitHub" /></a>
|
|
</p>
|
|
|
|
## Philosophy
|
|
|
|
If you are staring at the generated files, you are looking at the wrong layer.
|
|
|
|
The Python rewrite was a byproduct, and the Rust port is too. The real subject of this repository is the **agent coordination system** that made both possible: a human giving direction in Discord, agents decomposing the work, implementing in parallel, reviewing each other, fixing failures, and shipping without constant babysitting.
|
|
|
|
That is the point of this project.
|
|
|
|
- **the code is evidence, not the product**
|
|
- **the system that produces the code is the thing worth studying**
|
|
- **architectural clarity, task decomposition, and coordination matter more than typing speed**
|
|
- **clean-room rebuilding is valuable because it exposes process, not because it preserves an archive**
|
|
- **the future of software work is better agent orchestration, not more manual pane babysitting**
|
|
|
|
This repository exists to document and improve that loop: direction from the human, execution by the agents, notifications routed outside the context window, and repeated verification until the result is good enough to ship.
|
|
|
|
In other words: **stop staring at the files**. Study the workflow that produced them.
|
|
|
|
> [!IMPORTANT]
|
|
> **This repository is not affiliated with any coin, token, NFT, or crypto project.** It is software infrastructure work only, and any attempt to frame it as a cryptocurrency project is incorrect.
|
|
|
|
> [!IMPORTANT]
|
|
> **Rust port is now in progress** on the [`dev/rust`](https://github.com/instructkr/claw-code/tree/dev/rust) branch and is expected to be merged into main today. The Rust implementation aims to deliver a faster, memory-safe harness runtime. Stay tuned — this will be the definitive version of the project.
|
|
|
|
> If you find this work useful, consider [sponsoring @instructkr on GitHub](https://github.com/sponsors/instructkr) to support continued open-source harness engineering research.
|
|
|
|
---
|
|
|
|
## Rust Port
|
|
|
|
The Rust workspace under `rust/` is the current systems-language port of the project.
|
|
|
|
It currently includes:
|
|
|
|
- `crates/api-client` — API client with provider abstraction, OAuth, and streaming support
|
|
- `crates/runtime` — session state, compaction, MCP orchestration, prompt construction
|
|
- `crates/tools` — tool manifest definitions and execution framework
|
|
- `crates/commands` — slash commands, skills discovery, and config inspection
|
|
- `crates/plugins` — plugin model, hook pipeline, and bundled plugins
|
|
- `crates/compat-harness` — compatibility layer for upstream editor integration
|
|
- `crates/claw-cli` — interactive REPL, markdown rendering, and project bootstrap/init flows
|
|
|
|
Run the Rust build:
|
|
|
|
```bash
|
|
cd rust
|
|
cargo build --release
|
|
```
|
|
|
|
## Backstory
|
|
|
|
At 4 AM on March 31, 2026, I woke up to my phone blowing up with notifications. The Claw Code source had been exposed, and the entire dev community was in a frenzy. My girlfriend in Korea was genuinely worried I might face legal action from the original authors just for having the code on my machine — so I did what any engineer would do under pressure: I sat down, ported the core features to Python from scratch, and pushed it before the sun came up.
|
|
|
|
The whole thing was orchestrated end-to-end using [oh-my-codex (OmX)](https://github.com/Yeachan-Heo/oh-my-codex) by [@bellman_ych](https://x.com/bellman_ych) — a workflow layer built on top of OpenAI's Codex ([@OpenAIDevs](https://x.com/OpenAIDevs)). I used `$team` mode for parallel code review and `$ralph` mode for persistent execution loops with architect-level verification. The entire porting session — from reading the original harness structure to producing a working Python tree with tests — was driven through OmX orchestration.
|
|
|
|
The result is a clean-room Python rewrite that captures the architectural patterns of Claw Code's agent harness without copying any proprietary source. I'm now actively collaborating with [@bellman_ych](https://x.com/bellman_ych) — the creator of OmX himself — to push this further. The basic Python foundation is already in place and functional, but we're just getting started. **Stay tuned — a much more capable version is on the way.**
|
|
|
|
The Rust port was developed with both [oh-my-codex (OmX)](https://github.com/Yeachan-Heo/oh-my-codex) and [oh-my-opencode (OmO)](https://github.com/code-yeongyu/oh-my-openagent): OmX drove scaffolding, orchestration, and architecture direction, while OmO was used for later implementation acceleration and verification support.
|
|
|
|
https://github.com/instructkr/claw-code
|
|
|
|
|
|
|
|
## Related Projects
|
|
|
|
This repository sits inside a broader harness-engineering stack. If you want the surrounding tooling rather than only this port, start here:
|
|
|
|
### oh-my-codex (OmX)
|
|
|
|
[](https://github.com/Yeachan-Heo/oh-my-codex)
|
|
|
|
Primary orchestration layer for planning, delegation, verification loops, and long-running execution patterns such as `$team` and `$ralph`.
|
|
|
|
### oh-my-claudecode (OmC)
|
|
|
|
[](https://github.com/Yeachan-Heo/oh-my-claudecode)
|
|
|
|
Companion workflow layer for Claude Code-centered orchestration and multi-agent terminal workflows.
|
|
|
|
### clawhip
|
|
|
|
[](https://github.com/Yeachan-Heo/clawhip)
|
|
|
|
Event-to-channel routing for commits, PRs, issues, tmux sessions, and agent lifecycle updates — keeping monitoring traffic out of the active agent context window.
|
|
|
|
### oh-my-opencode (OmO)
|
|
|
|
[](https://github.com/code-yeongyu/oh-my-openagent)
|
|
|
|
Used here for later-pass implementation acceleration and verification support alongside OmX.
|
|
|
|
---
|
|
|
|
## 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
|
|
├── rust/ # Rust port (claw CLI)
|
|
│ ├── crates/api/ # API client + streaming
|
|
│ ├── crates/runtime/ # Session, tools, MCP, config
|
|
│ ├── crates/claw-cli/ # Interactive CLI binary
|
|
│ ├── crates/plugins/ # Plugin system
|
|
│ ├── crates/commands/ # Slash commands
|
|
│ ├── crates/server/ # HTTP/SSE server (axum)
|
|
│ ├── crates/lsp/ # LSP client integration
|
|
│ └── crates/tools/ # Tool specs
|
|
├── 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` and `oh-my-opencode`
|
|
|
|
This repository's porting, cleanroom hardening, and verification workflow was AI-assisted with Yeachan Heo's tooling stack, with **oh-my-codex (OmX)** as the primary scaffolding and orchestration layer.
|
|
|
|
- [**oh-my-codex (OmX)**](https://github.com/Yeachan-Heo/oh-my-codex) — scaffolding, orchestration, architecture direction, and core porting workflow
|
|
- [**oh-my-opencode (OmO)**](https://github.com/code-yeongyu/oh-my-openagent) — implementation acceleration, cleanup, and verification support
|
|
|
|
Key workflow patterns used during the port:
|
|
|
|
- **`$team` mode:** coordinated parallel review and architectural feedback
|
|
- **`$ralph` mode:** persistent execution, verification, and completion discipline
|
|
- **Cleanroom passes:** naming/branding cleanup, QA, and release validation across the Rust workspace
|
|
- **Manual and live validation:** build, test, manual QA, and real API-path verification before publish
|
|
|
|
### 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://instruct.kr/"><img src="assets/instructkr.png" alt="instructkr" width="400" /></a>
|
|
</p>
|
|
|
|
Join the [**instructkr Discord**](https://instruct.kr/) — the best Korean language model community. Come chat about LLMs, harness engineering, agent workflows, and everything in between.
|
|
|
|
[](https://instruct.kr/)
|
|
|
|
## Star History
|
|
|
|
See the chart at the top of this README.
|
|
|
|
## Ownership / Affiliation Disclaimer
|
|
|
|
- This repository does **not** claim ownership of the original Claw Code source material.
|
|
- This repository is **not affiliated with, endorsed by, or maintained by the original authors**.
|