claw-code/README.md

Project Claw Code

⭐ The fastest repo in history to surpass 50K stars, reaching the milestone in just 2 hours after publication ⭐

A community-built coding harness built on open agent frameworks

---

Built With

This project is built and maintained using a combination of open agent frameworks:

• clawhip — event-to-channel notification router and orchestration layer
• oh-my-openagent (OmO) — open-source agent framework
• oh-my-codex (OmX) — Codex CLI extensions and workflow tools
• oh-my-claudecode (OmC) — Claude Code workflow extensions

Important

The active Rust workspace now lives in rust/. Start with USAGE.md for build, auth, CLI, session, and parity-harness workflows, then use rust/README.md for crate-level details.

---

Backstory

This project began as a community response to the Claude Code exposure, and has since grown into a serious engineering effort to build the most capable open coding harness possible.

The entire development is orchestrated using the open agent frameworks listed above, with parallel code review, persistent execution loops, and architect-level verification driven through agent workflows.

The project is actively maintained by a distributed team using open tooling — no proprietary infrastructure required.

See the full origin story and recent updates here:

https://x.com/realsigridjin/status/2039472968624185713

---

Repository Layout

.
├── 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:

python3 -m src.main summary

Print the current Python workspace manifest:

python3 -m src.main manifest

List the current Python modules:

python3 -m src.main subsystems --limit 16

Run verification:

python3 -m unittest discover -s tests -v

Run the parity audit against the local ignored archive (when present):

python3 -m src.main parity-audit

Inspect mirrored command/tool inventories:

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.

Community

Join the claw-code Discord — come chat about LLMs, harness engineering, agent workflows, and everything in between.

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.