# Codegen

> Regenerate GraphQL types from API schema. Use when API schema has changed, GraphQL queries/mutations added or modified, or type errors in API calls.

- Skill: `cartridge-gg/codegen` (Agent Skill)
- Install (CLI): `npx skillmds@latest add cartridge-gg/codegen`
- Raw SKILL.md: https://api.skillmd.com/api/skills/cartridge-gg/codegen/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: cartridge-gg (https://skillmd.com/u/cartridge-gg)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/cartridge-gg/codegen

---


# GraphQL Codegen Skill

Regenerate GraphQL types from API schema.

## Usage

Run when:
- API schema has changed
- GraphQL queries/mutations added or modified
- Type errors in API calls

## Steps

1. Run `pnpm --filter @cartridge/keychain codegen`
2. Verify generated types in `packages/keychain/src/utils/api/graphql.ts`
3. Check for any TypeScript errors in files using the API
4. Run `pnpm test` to ensure tests still pass

## Configuration

- Schema source: https://api.cartridge.gg/query
- Config: `packages/keychain/src/utils/api/codegen.yaml`
- Auto-runs during build process

## Notes

- Codegen is also triggered automatically during `pnpm build`
- Generated files should not be manually edited
- Commit generated changes with schema updates