Codex Perigon CLI Deterministic OpenAPI Client Generation
Design a repeatable regression check for Perigon-generated code with stable output order and no machine-specific paths.
中文Install in Codex
Open Perigon CLI in Codex with the relevant generator and project OpenAPI fixtures.
- Review `.agents/skills/codegen/SKILL.md` and its requirements at the pinned GitHub commit.
- Create `.agents/skills/codegen/` in your project and save the reviewed file as `.agents/skills/codegen/SKILL.md`.
- Start Codex from that project's root, then type `$codegen` and select the matching skill.
Example task
Design a deterministic regression case for this sample OpenAPI input.
{"operations":["listLabels","getLabel"],"sameInputRuns":2,"outputKind":"TypeScript client","compare":"byte equality"}What to check
Assert `outputsEqual=true` after two passes over the same input. Check that generated call names are right and there is no `machine-specific path`.
Original SKILL.md on GitHub · Updated
Frequently asked question
Should I parse OpenAPI fields with ad hoc string splitting?
Use Microsoft.OpenApi for structured traversal when applicable and keep model extraction separate from output composition.