CLI Commands

The AutoSDK CLI provides commands for generating SDKs, scaffolding projects, and creating test files.

`autosdk generate`

The primary command — generates a .NET SDK from an OpenAPI or AsyncAPI specification.

autosdk generate <input> [options]

Input can be a local file path or URL to an OpenAPI/AsyncAPI spec (JSON or YAML).

Option	Description	Default
`--output`	Output directory for generated files	`Generated`
`--namespace`	C# namespace for generated code	Derived from project
`--clientClassName`	Name of the generated client class	`Api`
`--targetFramework`	Target framework (e.g., `net10.0`)	From project
`--single-file`	Generate all code in a single file	`false`
`--exclude-deprecated-operations`	Skip deprecated API operations	`false`

Option	Description
`--security-scheme`	Auth scheme in `Type:Location:Name` format (repeatable)
`--base-url`	Inject a base URL into the spec

Option	Description	Default
`--methodNamingConvention`	How method names are generated	`SimpleOperationId`

Available conventions:

SimpleOperationId — Uses the operationId directly: listPets becomes ListPets
MethodAndPath — Combines HTTP method and path: GET /pets/{id} becomes GetPetById
OperationIdWithDots — Preserves dots as namespace separators

Option	Description
`--websocket-class-name`	Override WebSocket client class name
`--types-namespace`	Reference types from another namespace (cross-namespace refs)
`--generate-models`	Whether to generate model classes (`true`/`false`)
`--json-serializer-context`	Reference existing `JsonSerializerContext`

Scaffolds a complete SDK project with solution, tests, CI workflows, and docs.

autosdk init <solution-name> <client-name> <openapi-spec> <company> [options]

Option	Description
`--add-mkdocs`	Include MkDocs Material documentation site
`--add-tests`	Include MSTest integration test project

autosdk init MyApi MyApiClient \
  "https://api.example.com/openapi.json" \
  MyCompany \
  --add-mkdocs --add-tests

Generates .http test files from an OpenAPI spec for use with VS Code REST Client or JetBrains HTTP Client.

autosdk http <input> [options]

Uses AI to generate an OpenAPI spec from API documentation pages (experimental).

autosdk ai spec-from-docs <url>