claw-code-parity README

The project's README from github.com/ultraworkers/claw-code-parity. As one markdown file: README.md.

Rewriting Project Claw Code

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

Star History Chart

Claw

Autonomously maintained by lobsters/claws — not by human hands

clawhip · oh-my-openagent · oh-my-claudecode · oh-my-codex · UltraWorkers Discord

[!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.

Want the bigger idea behind this repo? Read PHILOSOPHY.md and Sigrid Jin's public explanation: https://x.com/realsigridjin/status/2039472968624185713

Shout-out to the UltraWorkers ecosystem powering this repo: clawhip, oh-my-openagent, oh-my-claudecode, oh-my-codex, and the UltraWorkers Discord.

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 and friends like 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, oh-my-openagent, oh-my-claudecode, and 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

Tweet screenshot

Porting Status

The main source tree is now Python-first.

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

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

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.

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), layered on top of Codex.

OmX workflow screenshots

OmX workflow screenshot 1

Ralph/team orchestration view while the README and essay context were being reviewed in terminal panes.

OmX workflow screenshot 2

Split-pane review and verification flow during the final README wording pass.

Community

instructkr

Join the instructkr Discord — the best Korean language model community. Come chat about LLMs, harness engineering, agent workflows, and everything in between.

Discord

Star History

See the chart at the top of this README.

Ownership / Affiliation Disclaimer

claw-code-parity (ultraworkers/claw-code-parity)

Searching Database…

6.6K ·GitHub
Claw-code-parity
archived
Что это такое?Порт ради паритета проекта Claw Code — перестройка кодинг-харнесса Claude Code, за отслеживаемым снимком исходников которого автор решил не следить. Заявленная цель: доказать, что открытый кодинг-харнесс можно создать автономно, публично и на высокой скорости.
То есть это уже работающий кодинг-агент или всё ещё незавершённый порт?Сейчас это рабочее пространство для портирования, а не готовый агент: Python-дерево в src/ предоставляет CLI (main.py), который выводит манифесты и сводки портирования, а активный Rust-воркспейс лежит в rust/.
С чего мне начать?Начните с USAGE.md в rust/ — там сборка, аутентификация, CLI, сессии и воркфлоу parity-harness; rust/README.md рассказывает про крейты. На стороне Python quickstart выводит сводку портирования, манифест, список модулей и проверку.
Что нужно установить, чтобы запускать проект или ковыряться в коде?Требования нигде не описаны. Но так как репозиторий сочетает Rust-воркспейс (rust/ со своим Rust CI) и Python-дерево портирования (src/), чтобы работать по всему репозиторию, понадобятся оба тулчейна.
Порт уже работает как оригинал?Пока нет: он повторяет набор файлов из архива, имена подсистем и перечни команд/инструментов, но не эквивалентен по поведению в рантайме — в Python-дереве исполняемых рантайм-частей меньше. Репозиторий также заархивирован как временная работа на время миграции claw-code.
Почему бы просто не использовать утёкший исходник Claude Code, откуда всё это взялось?Взвесив юридические и этические вопросы (и прочитав эссе на эту тему), автор не захотел, чтобы утёкший снимок оставался отслеживаемым деревом исходников, поэтому репозиторий переключился на работу по портированию.
Это официально связано с Anthropic или Claude Code?Нет. В README сказано, что репозиторий не претендует на владение исходными материалами Claude Code и не аффилирован с Anthropic, не одобрен ею и не поддерживается ею.
Если код пишут не люди, то кто?Автономные воркфлоу claw (lobsters/claws): параллельные кодинг-сессии, событийная оркестрация, циклы восстановления и машиночитаемое состояние дорожек. Люди вроде Bellman / Yeachan Heo задают направление; реструктуризация и документация были скоординированы через oh-my-codex (OmX) поверх Codex.
В описании сказано, что это порт на Rust, а в README — что всё строится вокруг Python. Так что же верно?Есть и то и другое: баннер README указывает на активный Rust-воркспейс в rust/, а Porting Status говорит, что основное дерево исходников теперь в первую очередь на Python, в src/. Обе части сосуществуют, пока идёт миграция.
What are similar projects?munder-difflin, openrig, hive, deer-flow, ruflo, OpenTrade-Agent, fractal, agentbox
Which topics is it in?harness-engineering, harness, autonomous-agents, orchestration, multi-agent, developers, coding-agent, rust, codex, claude-code, automation, ai-agents
Creator
ultraworkers
Size
5.9 MB
Stars
6.6K
Updated
CommitApr 05
Age
6mo
Commits · 90 Days