원문: @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.