Commands

Reference for every command and flag exposed by the kubb CLI including init, generate, validate, mcp and studio.

The kubb CLI is the main way to run Kubb. It reads your configuration and runs the generation pipeline. It also scaffolds projects, validates specs, starts a Model Context Protocol server for LLM clients, and connects a project to Kubb Studio.

Usage

Terminal

USAGE kubb [COMMAND] [OPTIONS]

COMMANDS
  init                Initialize a new Kubb project with interactive setup
  generate [input]    Generate files based on a 'kubb.config.ts' file (default)
  validate            Validate a Swagger/OpenAPI file
  mcp                 Start the MCP server so an MCP client can interact with the LLM
  studio [action]     Connect this project to Kubb Studio and generate from the browser

Use kubb <command> --help for more information about a command.

Run kubb with no command and it runs kubb generate.

Available commands

Command	Description
`kubb init`	Scaffold a new Kubb project with an interactive wizard.
`kubb generate`	Run the code-generation pipeline from your `kubb.config.ts`.
`kubb validate`	Validate a Swagger/OpenAPI document without running the pipeline.
`kubb mcp`	Start a Model Context Protocol server for LLM clients.
`kubb studio`	Connect the project to Kubb Studio and generate from the browser.

Environment variables

The CLI reads these shared environment variables.

Variable	Type	Used by	Description
`KUBB_DISABLE_TELEMETRY`	`boolean`	all	Turn off anonymous usage telemetry. Set it to `1` or `true`.
`DO_NOT_TRACK`	`boolean`	all	Standard opt-out convention. Set it to `1` or `true`.
`KUBB_HOME`	`string`	`studio`	Directory the CLI keeps its Studio state in. Defaults to `~/.kubb`.
`KUBB_AGENT_TOKEN`	`string`	`studio`	Connect with an existing agent token instead of approving this machine.

Configuration

kubb init