AgentTape

실패한 Codex 실행 하나를 휴대용 회귀 테스트로 바꾸세요.

AgentTape는 오픈소스, 로컬 우선 Codex 플러그인으로, 지원되는 도구 실패를 편집되고 버전 관리되는 .tape 증거로 기록합니다. 무엇이 실패했는지 검사하고, 통제된 경계에서 캡처된 실행을 포크한 다음, 결과를 모델 호출 없이 CI에서 실행할 수 있는 오프라인 회귀 테스트로 저장하세요.

대부분의 추적 도구는 실패를 관찰하도록 돕습니다. AgentTape는 그 실패를 작고 검토 가능한 산출물로 전환하여 같은 버그가 재발하지 않도록 방지하는 데 목적이 있습니다.

Codex tool failure
        ↓
redacted .tape evidence
        ↓
inspect → inject one condition → compare branches
        ↓
save assertions → run offline in CI

AgentTape를 선택하는 이유

• 실패 산출물이지 또 다른 대시보드가 아닙니다. .tape는 버그 수정과 함께 검사, 검토, 공유, 커밋할 수 있는 휴대용 증거입니다.

• Codex 네이티브 캡처. 번들된 훅은 사용자가 검토하고 신뢰한 후 지원되는 수명 주기, 권한, 도구 이벤트를 기록합니다. 애플리케이션 계측이 필요 없습니다.

• 로컬 및 프라이버시 중시. 런타임 캡처는 활성 프로젝트 안에 유지되며, 일반적인 비밀 포함 필드는 내보내기 전에 재귀적으로 편집됩니다.

• 통제된 실패 주입. 권한 거부, 시간 초과, 잘못된 JSON, 잘린 응답 결과로 기록된 증거를 포크합니다.

• 오프라인 회귀 테스트. 구조적 재생과 어서션은 모델 호출 없이, 실제 도구 호출 없이 캡처된 증거를 사용합니다.

• 정직한 재생 신뢰도. AgentTape는 모든 외부 시스템을 완벽히 재현할 수 있다고 주장하지 않고, 적용 범위와 한계를 보고합니다.

Related MCP server: MCP QA Lab

GitHub에서 설치

전제 조건: Codex 및 Node.js 20 이상.

codex plugin marketplace add jiangkoumo/agenttape
codex plugin add agenttape@agenttape

설치 후 새 Codex 작업을 시작하고 번들된 훅을 신뢰하기 전에 검토하세요. 그런 다음 캡처는 활성 프로젝트의 .agent-tape/ 디렉터리에 저장됩니다.

2분 워크플로

먼저 지원되는 로컬 도구 호출이 실패할 때까지 Codex를 평소처럼 사용하세요. 그런 다음 요청하세요:

Use tool search to find AgentTape. List captured runs, inspect the latest
failed run, and explain the first recorded failure and replay confidence.

AgentTape는 네 가지 MCP 도구를 제공합니다:

저장된 회귀 테스트를 로컬 또는 CI에서 실행하세요:

node plugins/agenttape/scripts/agenttape.mjs test \
  tests/agenttape/fixture_permission_denied-timeout.tape

통과하는 어서션은 코드 0으로 종료됩니다. 검증 또는 어서션 실패는 0이 아닌 코드로 종료되며, 캡처된 비교 값은 실패 출력에서 생략됩니다.

.tape가 캡처하는 내용

Tape v1은 구조적 디버깅에 필요한 증거를 보관합니다:

• 실행 ID, 타임스탬프, 소스 적용 범위, 명시적 한계.

• 순서가 있는 수명 주기, 권한, 지원되는 로컬 도구 이벤트.

• 도구 입력, 출력, 명시적 실패, 첫 번째 실패 경계.

• 값이 제거된 위치를 기록하는 편집 매니페스트.

• 선택적 포크 메타데이터, 주입된 조건, 구조적 어서션.

• 소비자가 강력한 증거와 재생 전용 추적을 구분할 수 있도록 하는 재생 신뢰도 입력.

테이프 스키마는 UI 및 레코더 구현과 독립적입니다. Tape Schema v1을 참조하세요.

회귀 어서션

AgentTape는 현재 다음에 대한 결정적 검사를 지원합니다:

• 필드가 예상 값과 같은지.

• 도구가 존재하거나 존재하지 않는지.

• 재시도 횟수가 최대값 미만으로 유지되는지.

• 최종 실행 상태가 예상 상태와 일치하는지.

• 재생 신뢰도가 최소 임계값을 충족하는지.

검토된 회귀 산출물은 tests/agenttape/ 아래에 작성되며 기본적으로 덮어쓰지 않습니다.

재생 경계

AgentTape는 현재 전체 에이전트 재실행이 아닌 구조적 재생을 제공합니다. 캡처된 상태를 재사용하고, 기록된 도구 결과 하나를 대체하며, 주입된 경계에서 멈춥니다. 다운스트림 모델 추론을 재생성하지 않습니다.

호스팅된 도구, 캡처되지 않은 외부 상태, 타사 시스템의 변경 사항은 없을 수 있습니다. 편집 마커는 AgentTape의 편집기가 실행되었음을 증명하지만, 임의의 자유 형식 텍스트에 비밀이 없다는 것을 증명할 수는 없습니다. 공유하기 전에 모든 .tape를 검토하세요.

전체 신뢰 경계는 개인정보 보호 및 보안을 참조하세요.

저장소 구조

plugins/agenttape/
  .codex-plugin/plugin.json   # Codex plugin manifest
  hooks/hooks.json            # Recorder lifecycle hooks
  skills/capture-failure/     # Guided capture workflow
  dist/mcp-server.mjs         # Self-contained bundled MCP server
  scripts/                    # Recorder, schema, and assertion CLI
  schemas/                    # Versioned .tape schema

저장소에는 또한 src/ 아래에 선택적 Branch Canvas 프로토타입과 remote/ 아래에 실험적인 무상태 HTTP MCP가 포함되어 있습니다. 이들은 동일한 테이프 및 재생 개념을 사용하지만 Codex 플러그인을 설치하거나 사용하는 데 필요하지 않습니다.

로컬 개발

git clone https://github.com/jiangkoumo/agenttape.git
cd agenttape
npm ci
npm run test:plugin-release
npm run build:plugin
codex plugin marketplace add .
codex plugin add agenttape@agenttape

커밋된 plugins/agenttape/dist/mcp-server.mjs는 저장소를 빌드하지 않고도 마켓플레이스 설치가 실행되도록 합니다. MCP 소스가 변경될 때마다 이를 다시 빌드하고 커밋하세요.

선택적 Branch Canvas, Sites 어댑터 또는 원격 HTTP MCP 인터페이스를 변경할 때 npm test와 npm run build를 실행하세요.

제거

codex plugin remove agenttape@agenttape
codex plugin marketplace remove agenttape

기여

이슈와 풀 리퀘스트를 환영합니다. 기여, 행동 강령, 변경 로그을 참조하세요.

라이선스

MIT. 라이선스를 참조하세요.