recordfixture

Documentation

Overview

recordfixture captures real agent CLI output as fixture files for the e2e test suite. It is operated by hand, not by CI: every recording burns real API quota.

Examples:

go run ./cmd/recordfixture claude   --out internal/e2e/fixtures/claude
go run ./cmd/recordfixture codex    --out internal/e2e/fixtures/codex
go run ./cmd/recordfixture opencode --out internal/e2e/fixtures/opencode

Each agent gets a small set of fixture files (one per pipeline-step flavour: review with structured output, plain text, etc). The fake agent in cmd/fakeagent replays these byte-for-byte at runtime.

The recorder keeps no schema knowledge of its own — it just shells out to the real CLI and tees stdout/stderr/SSE/HTTP responses to disk. If the real wire format drifts upstream, re-recording produces the new fixture and the fake's replay automatically reflects it.