이 글에서 다루는 것

oh-my-pi. 이름만 들으면 라즈베리 파이 주변기기인 줄 안다. 근데 전혀 아니다. 이건 AI 코딩 에이전트 CLI고, 지금 오픈소스 에이전트 생태계에서 가장 공격적으로 진화하고 있는 하네스다.

Can Bölük이 2월에 쓴 “The Harness Problem”이라는 글이 있었다. 요지는 이거다: “지금 대화는 ‘어떤 모델이 코딩에 가장 좋은가’에 집중되어 있는데, 실제 병목은 하네스에 있다.” 같은 모델이라도 하네스(에이전트 도구면, 편집 포맷, 상태 관리)에 따라 성능이 10배까지 차이난다는 걸 벤치마크로 증명했다. Grok Code Fast 1은 patch 기반 에디트에서 6.7% 성공률이었는데, oh-my-pi의 Hashline 에디트 포맷을 쓰니 68.3%로 뛰었다. 모델이 아니라 도구 인터페이스가 성능을 결정한다는 실증이다.

이 글은 그 oh-my-pi가 정확히 무엇이고, 왜 지금 주목해야 하는지, 그리고 이게 에이전트 생태계에서 어떤 의미인지 정리한 기록이다.

이 글에서 다루는 것

• oh-my-pi의 정체 — 라즈베리 파이와 무관한 AI 코딩 에이전트 CLI
• Hashline 편집 — 내용 해시 기반 에디트 포맷이 모델 성능을 10배 올린 방법
• 55,000줄 Rust 코어 — ripgrep부터 PTY, AST, 브라우저까지 in-process
• 40+ LLM 프로바이더와 32개 내장 도구의 아키텍처
• 하네스 전쟁 — Anthropic의 차단, Google의 제재, OpenAI의 허용

oh-my-pi는 왜 만들어졌는가

“Pi is a coding agent. Oh My Pi is a harness.”

oh-my-pi는 Mario Zechner(@badlogicgames, libgdx 창시자)가 만든 Pi의 포크에서 시작했다. Pi 자체가 69.8k ★의 대형 프로젝트고, oh-my-pi는 여기에 13,000 커밋을 더해 완전히 다른 수준으로 진화시킨 결과물이다. Can Bölük은 보안 연구원, 리버스 엔지니어, Windows 커널 전문가 — 그래서인지 Rust로 된 저수준 최적화에 강점이 있다.

해결하는 문제는 단순하다: “코딩 에이전트의 성능은 모델보다 하네스가 결정한다.” Claude Code, OpenCode, Codex CLI 같은 도구들은 각자 다른 편집 포맷, 다른 도구 인터페이스, 다른 상태 관리를 가진다. 같은 GPT-5.2라도 어떤 하네스에서 쓰느냐에 따라 실제 코딩 성능이 극명하게 갈린다. oh-my-pi는 이 “하네스” 자체를 최적화하는 데 집중한다.

Slice 1: Hashline 편집 — 하네스가 성능을 결정하는 방식

oh-my-pi의 가장 큰 혁신은 Hashline이라는 에디트 포맷이다. 기존의 patch 기반이나 search/replace 기반 에디트와 근본적으로 다르다:

• 내용의 해시를 앵커로 사용한다. 파일의 특정 구문이 아니라, 내용의 해시값을 기준으로 편집 위치를 찾는다.
• 파일이 편집 중에 변경되면 stale을 자동 감지한다. 해시가 다르면 “이 파일은 이미 바뀌었다”고 알리고 재시도 루프를 제거한다.
• 모델이 잘못된 위치를 수정하는 문제를 원천 차단한다. 해시 기반이기 때문에 엉뚱한 곳을 고칠 수가 없다.

이게 The Harness Problem 포스트의 핵심 데이터 포인트였다. Grok Code Fast 1은 search/replace 기반 에디트에서 6.7% 성공률. 같은 모델이 Hashline에서 68.3%로 뛰었다. 모델은 그대로인데, 인터페이스만 바꿨을 뿐인데 10배 차이가 났다.

Slice 2: 55K LOC Rust — 모든 게 in-process

oh-my-pi의 코어는 약 55,000줄의 Rust로 되어 있다. 단순한 CLI 래퍼가 아니라, 일반적으로 별도 프로세스로 돌아가는 도구들을 전부 in-process로 내장했다:

• ripgrep — 빠른 코드 검색이 in-process에서 동작
• glob — 파일 패턴 매칭
• bash — 명령어 실행
• AST — ast-grep 기반 구조적 코드 탐색/변경
• PTY — pseudo-terminal
• 브라우저 — Puppeteer + CDP로 Slack도 브라우저 API로 읽음
• LSP — 언어 서버 프로토콜 (rename, references, code actions)
• DAP — 디버거 프로토콜 (lldb, dlv, debugpy 직접 구동)

이게 왜 중요한가? 에이전트가 도구를 호출할 때마다 별도 프로세스를 spawn하면 오버헤드가 생긴다. 모든 게 in-process면 그 오버헤드가 사라진다. 특히 AST 검색처럼 반복적인 작업에서 차이가 크다. oh-my-pi의 40+ LLM 프로바이더 지원도 같은 Rust 코어 위에서 돌아간다. Anthropic, OpenAI, Google, xAI, Grok, MiniMax부터 로컬 Ollama/LM Studio까지 — 단일 바이너리로 모든 프로바이더를 커버한다.

Slice 3: 4개 진입점과 서브에이전트 아키텍처

oh-my-pi는 하나의 CLI지만 네 가지 진입점을 가진다:

• TUI — 대화형 인터페이스. 터미널에서 omp를 바로 실행
• -p 플래그 — one-shot 명령. `omp -p “fix this bug”`
• RPC — stdio NDJSON. 다른 도구가 oh-my-pi를 백엔드로 호출
• ACP — Agent Client Protocol. Zed 에디터와 직접 통합

서브에이전트 시스템도 빼놓을 수 없다. 작업을 격리된 워크트리로 분산시키고 타입 있는 결과를 반환한다. Advisor라는 두 번째 모델이 모든 턴을 감시하며 인라인 노트를 주입한다. `omp join`으로 실시간 세션 공유, QR 코드, 브라우저 뷰도 지원한다.

Stream Rules이라는 재미있는 기능도 있다. “시간여행” 규칙 매칭이라고 하는데, 모델이 규칙을 위반하는 토큰을 생성하는 순간 mid-token으로 중단하고 규칙을 주입한다. 규칙을 생성 후 검증하는 게 아니라, 생성 중에 차단한다.

왜 지금 oh-my-pi인가

oh-my-pi의 GitHub는 17,400 ★, npm 주간 61,741 다운로드, 500+ 버전. 첫 배포는 2025년 말로 추정되는데 이미 엄청난 속도로 진화 중이다.

더 중요한 건 이게 하네스 전쟁의 한복판에 서 있다는 점이다:

• Anthropic이 OpenCode를 Claude Code OAuth 엔드포인트에서 차단했다. 생태계를 독점하려는 움직임으로 읽힌다.
• Google은 Can Bölük이 oh-my-pi로 Gemini를 벤치마크 돌리다가 계정을 영구 정지시켰다. “하네스 연구”를 위협으로 간주한 사례.
• OpenAI는 반대 방향으로 간다. Codex CLI가 oh-my-pi/OpenCode 등의 Max subscription 사용을 공식 허용했다.

oh-my-pi는 이 전쟁에서 가장 중립적이고 확장성 높은 위치에 있다. 40+ 프로바이더, 모든 구독 OAuth 지원, 가장 정교한 에디트 포맷. Claude Code가 “Anthropic 전용”이라면, Codex CLI가 “OpenAI 전용”이라면, oh-my-pi는 “너의 모델, 너의 규칙, 너의 하네스”라는 입장이다.

결정 테이블 — oh-my-pi vs 경쟁 하네스

항목	Claude Code	OpenCode	Codex CLI	oh-my-pi
LLM 프로바이더	Anthropic 전용	다수 (차단 위험)	OpenAI 전용	40+
편집 포맷	search/replace	search/replace	patch 기반	Hashline
코어 언어	TypeScript	TypeScript	TypeScript	Rust
내장 도구	기본	기본	기본	32개
LSP/DAP	부분	부분	없음	내장
서브에이전트	기본	기본	기본	격리 워크트리
에디터 통합	ACP	ACP	없음	ACP + RPC
라이선스	독점	Apache 2.0	Apache 2.0	MIT

닫으며

oh-my-pi는 단순한 “또 다른 코딩 에이전트 CLI”가 아니다. 이건 하네스 그 자체에 대한 선언문이다. Can Bölük이 해시 기반 에디트로 증명한 건 단순하다: “모델이 아니라 인터페이스가 성능을 결정한다.” 이 통찰은 LLM 생태계 전체의 패러다임을 바꾼다. 모델 경쟁이 아니라, 모델과 인간(과 다른 에이전트) 사이의 인터페이스 경쟁이 진짜 승부처라는 것.

Anthropic은 차단하고, Google은 제재하고, OpenAI는 허용한다. 누가 이기든, oh-my-pi는 이 전쟁의 최전선에 서 있다. 벤더 락인에 맞서는 진정한 오픈 하네스로서.

읽어줘서 고맙다.