병렬 코딩 에이전트는 창이 아니라 디렉터리를 나눠야 한다
Herdr 문서는 oh-my-pi 세션을 다시 띄울 수 있는 터미널을 설명한다. oh-my-pi README는 코딩 에이전트와 로컬 사용량 대시보드를 설명한다. Magpie README는 oh-my-pi로 들어가는 길을 포함한 로컬 모델 게이트웨이를 설명한다. 그 페이지들은 저자가 셋을 같이 돌렸다는 주장이 아니다. 토이는 딕셔너리 둘과 해시이고, 같은 파일 수정을 충돌로 표시한다.
2026-11-10 확인. 출발 링크는 X 게시물 status/2119443089760960679이다. 글과 그림은 사실로 쓰지 않는다. 같은 날 연 페이지는 herdr 통합, herdr 세션 상태, oh-my-pi README, magpie README, git-worktree이다. 도구는 설치하지 않았고 개인 세션은 보고하지 않는다. 토이는 agent-worktree-conflict-toy.py다.
먼저 결론
공식 페이지 셋은 서로 다른 일을 설명한다.
Herdr 통합 문서는 OMP 확장을 설치하고, 소켓으로 생명주기 상태를 보고하고, 자기 서버가 다시 시작된 뒤 omp --resume=으로 창을 재개할 수 있다고 한다. 세션 상태 페이지는 그 재개 명령을 Claude Code, Codex, Cursor Agent CLI 등과 나란히 적는다. 그 페이지들에서 Herdr는 창을 붙들고 다시 시작하는 법을 아는 쪽이다.
oh-my-pi README는 omp가 코딩 에이전트이고, Mario Zechner의 Pi를 포크해 코딩 우선 표면으로 다시 썼으며, 세션과 서브에이전트와 도구가 있다고 한다. 패키지 목록의 @oh-my-pi/omp-stats는 거기서 AI 사용 통계를 위한 로컬 관측 대시보드라고 적힌다. 그것이 README의 사용량 추적 문장이다. 이 글은 대시보드를 열지 않았다.
Magpie README는 하나의 로컬 게이트웨이라고 한다. 설치된 에이전트, oh-my-pi를 포함해, 모델을 고르고, 할당량이 떨어지면 다음으로 넘어간다. 지원 에이전트 목록에 oh-my-pi가 있다. README의 일은 라우팅과 할당량이지 두 번째 작업 트리가 아니다.
나란히 켠다고 두 에이전트가 한 파일을 고치는 일이 막히지는 않는다. Git의 worktree 명령이 토이가 말하는 격리이다. 토이는 그 제품들이 아니다.
문서가 실제로 말하는 것
2026-11-10에 연 Herdr 통합 페이지는 herdr integration install omp가 PI_CODING_AGENT_DIR나 PI_CONFIG_DIR가 다른 곳을 가리키지 않으면 ~/.omp/agent/extensions/ 아래에 herdr-omp-agent-state.ts를 쓴다고 한다. Pi와 OMP가 그 디렉터리를 같이 쓰게 되면 Herdr가 OMP 설치를 거부한다고 페이지는 말한다. OMP 통합은 라벨 omp, 생명주기 상태, 세션 id를 보고한다. Herdr 재시작 뒤의 재개는 omp --resume=이다. 같은 페이지는 일부 통합이 상태를 보고하고, 그러면 Herdr가 화면을 읽는 대신 그 보고를 쓴다고 한다. 나머지는 화면 감지에 맡긴다. 그 페이지에서 OMP는 보고하는 쪽에 있다.
세션 상태 표는 재개 명령의 목록이고, 각각 최소 통합 버전이 있다. OMP 행은 버전 3과 omp --resume=이다. Pi 행은 pi --session이다. 다른 명령이다. 페이지는 두 에이전트가 세션 파일을 공유한다고 말하지 않는다.
oh-my-pi README는 설치 줄(bun install -g @oh-my-pi/pi-coding-agent, Homebrew can1357/tap/omp, curl 설치, Nix)을 주고, 코어를 Rust, 에이전트 표면을 TypeScript로 설명한다. @oh-my-pi/omp-stats는 위와 같고, @oh-my-pi/pi-mnemopi는 로컬 SQLite 메모리 엔진이라고 적는다. 이 글은 어느 패키지도 실행하지 않았다. README의 제공자 수 같은 숫자는 README의 홍보 문장이지 여기서 잰 값이 아니므로 결과로 반복하지 않는다.
Magpie README는 magpie provider add, magpie claude …, magpie codex …, magpie quota, 라우팅 그룹(smart, order, rotate, usage, pace)을 설명한다. 그룹은 요청을 키들에 나눈다. README는 프롬프트 캐시를 유지할 가치가 있는 동안 대화가 답한 계정에 남다고 한다. 그것은 게이트웨이의 비용과 할당량 통제다. 에이전트 안의 승인 대기열이 아니고, 여기서 읽은 README 절은 git worktree를 설명하지 않는다.
격리는 디렉터리다
git 문서에서 git worktree add는 연결된 작업 트리를 더해, 한 번에 둘 이상의 브랜치를 체크아웃할 수 있게 한다. 한 작업 트리의 프로세스 둘은 인덱스와 파일을 공유한다. 작업 트리 둘의 프로세스 둘은 그 파일을 공유하지 않는다. 객체 데이터베이스는 공유하므로, 둘 다 갱신하려는 브랜치는 나중 병합이지 다른 트리를 조용히 덮어쓰는 일이 아니다.
토이가 이름 붙이는 실패는 병합보다 단순하다. 두 트리가 공통 기준에 대해 같은 경로를 바꾸면, 누군가 두 diff를 읽어야 한다. 다른 경로를 바꾸면 경로 집합은 서로 겹치지 않는다.
승인은 그 앞에 있지, 그 대신이지 않다. 도구가 돌기 전에 사람에게 묻는 대기열은, 다른 창이 이미 같은 함수를 썼는지는 알아채지 못한다. 여기서 읽은 Herdr 페이지는 생명주기 상태와 재개를 말한다. 연 절에서는 에이전트 사이의 파일 잠금을 정의하지 않는다. Magpie의 할당량 화면도 그렇지 않다. 잠금을 원하면 그것은 worktree 경계와, 각 작업이 건드릴 경로에 대한 규칙이다.
토이
agent-worktree-conflict-toy.py는 표준 라이브러리의 hashlib를 쓴다. "worktree"는 딕셔너리다. Python 3.12.3, 2026-11-10:
disjoint
README editors=['right'] conflict=False
src editors=['left'] conflict=False
overlap
README editors=['right'] conflict=False
src editors=['left', 'right'] conflict=True
left_src_sha=0111afd387e1 right_src_sha=a80ac71a28f9 base_src_sha=cc42155088fc
먼저 left는 src를, right는 README를 바꾼다. 편집자가 둘인 경로는 없다. 그다음 right도 src를 바꾼다. 그 경로는 conflict=True다. 해시 셋은 두 수정이 같은 바이트가 아니고 기준도 아니라는 것을 보여 준다. 파일은 git을 호출하지 않고 병합하지 않는다.
사실과 해석
| 문장 | 어느 쪽 |
|---|---|
herdr integration install omp는 확장을 쓰고 omp --resume=으로 재개할 수 있다. Pi와 확장 디렉터리를 공유하면 거부된다. | 2026-11-10 herdr.dev 통합·세션 상태 페이지. |
omp는 Pi 포크이자 코딩 에이전트다. @oh-my-pi/omp-stats는 로컬 사용량 대시보드로 설명된다. | oh-my-pi README. 실행하지 않음. |
Magpie는 로컬 게이트웨이이고, oh-my-pi를 포함한 설치된 에이전트를 고른 모델로 보낼 수 있으며 magpie quota를 둔다. | magpie README. 실행하지 않음. |
| 연결된 worktree는 두 번째 체크아웃이다. | git-worktree 문서. |
| 경로가 갈라진 수정은 충돌이 아니다. 양쪽이 고친 경로는 충돌이다. | 이 토이. git 병합도 제품 로그도 아님. |
| 이 세 도구를 실제 과제에서 같이 썼다. | 주장하지 않음. X 게시물은 링크뿐이다. |
출처
- X. 링크만. status/2119443089760960679
- herdr, 통합, 세션 상태와 복원. 2026-11-10에 열었다.
- can1357/oh-my-pi. 같은 날 README를 읽었다.
- yetone/magpie. 같은 날 README를 읽었다.
- Git, git-worktree.
- agent-worktree-conflict-toy.py. 위에 인용한 줄은 2026-11-10 실행이다.