entwurf
독립된 pi, pi-durable, Claude Code, Codex, Copilot, OMP, Antigravity 세션이 서로의 인증·도구·트랜스크립트를 빼앗지 않은 채 garden id 로 서로를 부를 수 있게 하는 얇은 다리(bridge)입니다.
0.34.0 — 네이티브 durable과 정합한 Herdr 플러그인
Core v0.34.0과 Herdr 플러그인 스냅샷이 발행됐습니다(2026-10-09). 플러그인은 레지스트리 무결성 pin으로 기존 npm 0.34.0 아티팩트를 받으며, 독립된 플러그인 버전도 0.34.0입니다. 스냅샷은 두 번째 npm 릴리즈가 아니며, core 릴리즈의 Latest도 그대로입니다.
일반 Pi는 선택 사항이고 지원 범위는 >=1.1.0 <1.2입니다. built-in MCP로 다른 하네스와 같은
entwurf-bridge를 부릅니다. 직접 설치의 pi-durable 경로는 고정한 업스트림 앱/TUI와 exact
Pi 1.1.0 SDK 아홉 종을 싣습니다. 별도 런타임 checkout이나 일반 Pi CLI가 필요하지 않습니다.
Core 0.34.0에는 살아있는 background-task footer와 명시적인 native-module 디렉터리 입구가 더해졌습니다.
Herdr에서 시작하기
# 기존 Herdr 워크벤치에서 pi 및/또는 Claude Code를 통합한 뒤
herdr plugin install junghan0611/entwurf/plugins/herdr --ref v2026.10.9-herdr.0.34.0 --yes
# Herdr pane에서 pi를 Entwurf 시민으로 시작
pi --entwurf-control이미 Herdr를 갖춘 경우의 짧은 경로이며, 이제 발행한 플러그인 스냅샷에 고정합니다.
실제 공개 npm 설치 여정은 main이 스냅샷과 같은 8ed4d1a일 때 통과했습니다.
태그 자체를 --ref로 사용한 설치는 아직 미측정이며 별도의 PASS로 주장하지 않습니다.
플러그인을 측정한 Herdr 본체는 0.9.3이고, 입학 하한은 Herdr ≥0.9.0으로 유지합니다.
Node ≥24, npm, git, 네트워크와 각 하네스의 첫 실행·Herdr 통합은 여전히 필요합니다.
이 플러그인은 하네스·구독·로그인을
설치하지 않습니다. 한 번만 하면 되는 과정과 선택적인 상태 pane은 Herdr 플러그인 README에서 다룹니다.
0.30.1 checkout-carrier 설치에서 올라오려면 먼저 명시적인 certified deactivate가 필요합니다.
플러그인은 PATH에 entwurf bin을 더하지 않으므로 가이드의
설치된 절대 bin 경로로 제거를 따르세요.
인증되지 않은 옛 상태의 거부는 무조건 삭제하거나 마이그레이션해도 된다는 뜻이 아닙니다.
직접 설치 — 더 넓은 표면
managed pi-durable, 네이티브 Codex, Copilot, OMP, Antigravity 구성이 필요하거나 Herdr 밖에서 작업한다면 직접 설치 경로를 사용하세요.
npm install -g "@earendil-works/pi-coding-agent@>=1.1.0 <1.2" # 일반 pi를 쓸 때만
npm install -g @junghanacs/entwurf@0.34.0
entwurf setup /path/to/your-project
entwurf pi
entwurf check-bridgesetup 한 번이면 호스트에 있는 모든 하네스를 찾아 구성하고 각각을 PASS / SKIP / FAIL 로 보고합니다.
entwurf pi는 pi를 control-socket 가든 시민으로 시작합니다. Herdr 통합은 현재 의도적으로
좁습니다. Herdr에 이미 통합된 pi와 Claude Code만 활성화합니다.
entwurf pi-durable은 패키지에 실린 네이티브 durable 앱을 엽니다. 선택적인
--native-module <absolute file> 또는 --native-module-dir <absolute directory>는 명시한
네이티브 확장만 싣습니다. 고전 Pi API shim이 아니며, 런타임·인증·queue·SQLite·transcript·recovery는
업스트림 소유로 남습니다.
직접 fresh-call은 pi, Claude Code, Copilot, OMP, Codex, managed pi-durable의
여섯 backend입니다. Herdr fresh-call과 플러그인 wiring은 여전히 pi / Claude Code 둘뿐입니다.
bare --kind 하나로 entwurf pi-durable …를 담을 수 없습니다.
durable-on-Herdr pilot은 아직 미측정입니다.
수동 native record/self-fetch → Herdr 감지 → GLG 판단 순서이며 wrapper나 fallback을 만들지 않습니다.
Antigravity의 기존 native-push delivery가 fresh-call 지원을 뜻하지는 않습니다.
디스패치 방식
entwurf_v2
이미 존재하는 가든 시민에게 보내는 정본 디스패치 — control-socket 전송, meta-mailbox 적재, 또는 살아있는 대화로의 native-push.
entwurf_fresh_call
Herdr 안에서는 호출자의 워크스페이스에 새 pi·Claude Code 형제를, 밖에서는 tmux에 새 형제를 엽니다. 콜백으로 garden id를 알아냅니다.
entwurf_resume_call
숨은 턴을 실행하지 않고, 잠든 pi 시민을 자신의 garden id로 보이는 tmux 창에서 다시 엽니다.
독립된 하네스들, 하나의 주소 공간
pi
살아있는 control-socket 표면을 갖고, Pi 1.1 built-in MCP로 같은 bridge를 부르는 가든 네이티브 세션.
pi-durable
garden identity와 명시적인 양방향 self-fetch를 더한 네이티브 durable 앱/TUI. 런타임과 저장소는 업스트림 소유로 남습니다.
Claude Code
자신의 인증·도구·트랜스크립트를 유지한 채 이어지는 독립 세션.
Codex
다른 가든 시민과 나란히 주소를 갖는 자신의 하네스 세션.
Copilot CLI
자신의 인증·도구·트랜스크립트를 유지한 채 이어지는 독립 세션.
OMP
자신의 런타임 경계를 지닌 보이는 형제 세션.
Antigravity
실시간 native-push 딜리버리를 갖춘 독립 세션.
Herdr는 워크벤치를, Entwurf는 주소를 맡습니다
Herdr 안에서 Entwurf는 통합된 pi·Claude Code 세션을 활성화하고, 선택적인 읽기 전용 상태 pane으로 그 시민의 보이는 위치를 알려 줍니다. 워크벤치는 Herdr가 소유하지만, Entwurf는 이 하네스들을 잇는 독립적인 가든 주소·딜리버리 층입니다. Herdr 전용 플러그인으로 축소되지 않습니다.
garden id는 의도된 어휘입니다
session id, worker, delegate, subagent의 장식적 동의어가 아닙니다. 각 하네스는 자신의 정체성과 트랜스크립트를 그대로 유지하며, entwurf는 형제 세션들 사이에 좁은 주소 표면 하나만 제공합니다.