Eight commands. One job: keep your generated client honest relative to the OpenAPI spec. No mystery subcommands, no unreleased doctor/resolve fluff — just the workflow you'll actually run.

Command summary

Command	Purpose	When to use
`init`	Full project setup	First time, new repo, "we should type our API"
`fetch`	Fetch spec + generate	API changed, CI, "make it match staging"
`generate`	Generate from cache	Offline, quick regen, local spec already cached
`watch`	Continuous polling	Dev loop — types stay warm while you break the UI
`status`	Show current state	"Why is nothing typed?" debugging
`validate`	Check spec quality	Before merge, before blaming the generator
`diff`	Preview changes	Before `fetch` nukes your assumptions
`plugins`	Manage Vite codegen plugins	Surfaces / Side Panels opt-in

Typical workflow

Initial setup

chowbea-axios init

Writes api.config.toml, scaffolds api.client.ts, adds npm scripts. First fetch fills _generated/ with api.contracts.ts, api.types.ts, and api.operations.ts.

During development

chowbea-axios watch

# or when you feel like it
chowbea-axios fetch

Wire api:watch next to your dev server. See The Query Layer for the dev:all pattern.

Before deployment

chowbea-axios validate --strict
chowbea-axios diff
chowbea-axios fetch --force

Validate catches missing operationId and broken refs. Diff shows what changed. Fetch applies it.

Common flags

Available on most commands:

Flag	Short	Description
`--config`	`-c`	Path to custom config file
`--quiet`	`-q`	Suppress non-error output
`--verbose`	`-v`	Show detailed output
`--headless`	-	Force headless mode (auto-detected in non-TTY environments)
`--help`	`-h`	Show help for the command
`--version`	-	Show CLI version

NPM scripts

After init, your package.json gets the boring stuff automated:

package.json

{
  "scripts": {
    "api:fetch": "chowbea-axios fetch",
    "api:generate": "chowbea-axios generate",
    "api:watch": "chowbea-axios watch",
    "api:status": "chowbea-axios status",
    "api:validate": "chowbea-axios validate",
    "api:diff": "chowbea-axios diff"
  }
}

npm run api:fetch
pnpm api:watch
yarn api:status

Commands Overview

Command summary

Typical workflow

Initial setup

During development

Before deployment

Common flags

NPM scripts

Detailed documentation

init

fetch

generate

watch

status

validate

diff

plugins

On this page