# Voxgig SDK Generator

> The generator reads your OpenAPI spec, extracts a type-safe semantic model of your API, and generates six surfaces from that model. Deterministic: same spec, same output, every time.

Install: `npm create @voxgig/sdkgen`
Source: https://github.com/voxgig/sdkgen (MIT)

## The six output surfaces

1. **SDK**: uniform client libraries in TypeScript, JavaScript, Go, Python, PHP and Lua. You call entities and operations, not URLs.
2. **CLI**: a real command-line tool over your API, entity-shaped, for scripts, CI and on-call.
3. **MCP Server**: a Model Context Protocol server, so Claude, ChatGPT, Cursor and Cline can call your API as a native tool.
4. **Agent Skills**: generated markdown that teaches a coding agent your entities and operations.
5. **REPL**: an interactive shell over the same entities.
6. **Semantic Model**: the type-safe model of your API, entities, attributes and operations. The ground truth the other five are generated from.

## How it differs from the alternatives

- **Ship no SDK.** You lose the enterprise deal, or you ship raw HTTP and absorb the support load.
- **Hand-write per language.** Every API change is N writes, and the SDKs drift from the spec.
- **AI-assisted generation.** A real trade-off. Ownership cost is identical to hand-writing, and the output is non-deterministic. Useful for exploration, harder to live with for libraries customers compile against for years.
- **Other open-source generators.** Wooden output, SDK only, nobody behind it when it breaks.
- **Paid SaaS SDK products.** SDK only, closed source, priced per seat.
- **Hand-rolled MCP server.** Solves MCP once, then drifts from your SDK on the next spec change.

Voxgig generates all six surfaces from one model, deterministically, under MIT, into your repo.

## Frequently asked

- **Is it really MIT?** Yes. The generator and templates are MIT. The generated SDKs are yours.
- **What if Voxgig disappears?** The generator is on npm and GitHub, and the generated code is in your repo. Nothing breaks.
- **Java and C#?** Generated on request, or as part of an API Experience engagement.
- **What are Agent Skills?** Generated markdown describing your API at the entity and operation level, in the format coding agents read as a skill.

## Machine-readable

- Catalog index: https://voxgig.com/api/sdk/catalog.json
- Per SDK: https://voxgig.com/api/sdk/{slug}.json and https://voxgig.com/voxgig-sdk/{slug}.md
- CSV: https://voxgig.com/sdk/voxgig-sdk.csv