원문: @OrcaRouter 출시 포스트 · 저장소 Continuum-AI-Corp/OrcaReplay(Apache-2.0, TypeScript, ★274) · 수집일: 2026-10-04
개요
OrcaReplay는 모델 API 게이트웨이 OrcaRouter 팀이 공개한 **에이전트 실행 “타임머신”**이다. Claude Code, Codex, Grok CLI, Hermes 같은 에이전트를 수정하지 않고 실행 과정을 하나의 타임라인으로 기록한다. 기록에는 모델 호출, 셸 명령과 종료 코드, 파일 변경이 모두 들어간다. 기록한 실행은 네트워크를 끈 채 바이트 단위로 똑같이 재생할 수 있고, 원하는 단계부터 다른 모델로 포크할 수도 있다. 비용과 토큰만 보여 주는 관측 도구로는 “왜 마이그레이션 파일을 지웠나” 같은 질문에 답하기 어렵다. OrcaReplay는 실행 자체를 되돌려 주는 방식으로 이 질문에 답한다.
사용법
npm i -g orcareplay # 패키지명 orcareplay, 명령은 orca
orca record claude # 에이전트를 그대로 실행하며 녹화
orca replay last # 네트워크 차단 재생 — 토큰·비용 0
orca replay last --from 4 --model claude-haiku-4-5 --ui
orca compare last --from 4 --models a,b
orca show last / orca graph last # 이벤트 순서 / 인과 그래프orca quickstart는 버그가 있는 예제 프로젝트와 그 버그를 고치는 녹화본을 만들어 키나 네트워크 없이 재생을 보여 준다.orca replay last --ui는 실행을 HTML 한 파일로 열고,orca export last --card bug.svg는 인과 체인을 카드 이미지로 그린다(저자 후속 포스트).
동작 원리
- 모델 API는 상태가 없어서 에이전트는 매 턴마다 대화 전체와 직전 도구 결과를 다시 보낸다. 그래서 모델 앞에 둔 프록시 하나가 루프 전체를 볼 수 있다. 에이전트는 패치하지 않고 base URL 환경 변수 두 개만 바꾼다.
- 프로토콜에 드러나지 않는 정보는 다른 계층이 채운다. PATH shim이 종료 코드·시간·스트림을, MCP JSON-RPC tee가 MCP 호출을, shadow git index가 턴별 작업공간 스냅샷을, fetch hook이 API 호스트를 하드코딩한 에이전트를 맡는다. 이렇게 6개 캡처 계층이 하나의 트레이스(
.orca/runs/...)로 합쳐진다. - ChatGPT 구독으로 로그인한 Codex처럼 엔드포인트를 바꿀 수 없는 에이전트는 opt-in
--tls-intercept로 기록한다. - 정확 재생, 포크, 비교는 서로 다른 기능이 아니다. 기록에서 읽다가 네트워크로 넘어가는 커서 위치만 다르다. 체크포인트는 대화 접두부가 완결되고 작업공간 스냅샷이 있는 지점에서 파생되므로 실제로 존재했던 상태에서만 포크된다.
orca graph는 기록된 엣지(응답 안의 tool_use 블록)와 추론된 엣지(파일 변경을 특정 도구 호출에 귀속한 것)를 구분해서 표시한다.
한계·주의
- 재생은 샌드박스가 아니다. 기록된 도구 호출을 실제로 다시 실행하므로, 셸의
curl처럼 자체 소켓을 여는 도구는 보장 범위 밖이다. - OrcaRouter 팀이 만든 도구라서
orca setup과orca compare는 기본적으로 OrcaRouter 엔드포인트를 가리킨다.
연결
에이전트 트레이스를 내구 메모리로 쓰는 접근은 2026-06-25-langsmith-engine-agent-traces-durable-memory와 비교해 볼 수 있다. 실행을 관측하고 검증 가능하게 만든다는 관점은 2026-09-06-x-lunarresearcher-harness-engineering-guide의 “최종 답이 아니라 실행을 관측하라”와 같은 방향이다. 상위 분류는 moc-ai-agents-harness.