create-sdkgen

Scaffold a new Voxgig SDK Generator project — turn an OpenAPI spec into idiomatic, tested, multi-language client SDKs (TypeScript, Python, Go, PHP, Ruby, Lua, plus a CLI and MCP server).

Quickstart

# 1. Scaffold a project from your OpenAPI 3 spec
create-sdkgen my-api -d ./openapi.yaml -o ./my-api-sdk

# 2. Add the languages you want + offline test mode
cd my-api-sdk/.sdk
npx voxgig-sdkgen target add ts py go
npx voxgig-sdkgen feature add test

# 3. Generate the SDKs (builds the .sdk sources, then runs the generator)
npm run generate

# 4. Verify
cd ../ts && npm install && npm run build && npm test

You shape the SDK by editing the model in .sdk/model/ (entities, ops, fields); everything under the language directories (ts/, py/, …) is generated output and is overwritten on each regenerate.

Options

| Flag | Meaning | | --- | --- | | <name> | SDK name (kebab-case), the package base name | | -d, --def <spec> | OpenAPI 3 spec file (.yaml/.json) | | -o, --folder <dir> | output directory | | -t, --target <langs> | targets to add during scaffold (e.g. ts,py,go) | | -f, --feature <feats> | features to add (e.g. test) | | --no-install | skip npm install | | -h, -v | help, version |

Building an SDK with an AI agent?

Point your agent at AGENTS.md — the full end-to-end guide (spec → scaffold → generate → test → publish), what to edit vs. what is generated, the doc-example test guarantee, and the real-world shape gotchas.

The toolchain

• create-sdkgen (this package) — scaffolds the project.
• @voxgig/apidef — parses your OpenAPI spec into the model.
• @voxgig/sdkgen — generates the SDKs from the model.