status is the "what's going on?" command. Config location, cache age, endpoint counts, generated file timestamps, which client files exist. When something isn't typed and nobody knows why, start here.

Usage

chowbea-axios status [flags]

What it shows

Config — location and key settings
Spec — cache status, hash, and age
Endpoints — count and breakdown by HTTP method
Generated files — status and last modified time
Client files — which editable files exist

Flags

Flag	Short	Description	Default
`--config`	`-c`	Path to api.config.toml	Auto-detected
`--quiet`	`-q`	Suppress non-error output	`false`
`--verbose`	`-v`	Show detailed output	`false`

Example output

╭──────────────────────────────────────────────────
│ Status
├──────────────────────────────────────────────────
│
│ Config: api.config.toml
│   endpoint: http://localhost:3000/docs/swagger/json
│   output: app/services/api
│
│ Spec:
│   cached: yes (hash: a1b2c3d4, 5 min ago)
│   endpoints: 42 total
│     GET: 18  POST: 12  PUT: 6  DELETE: 4  PATCH: 2
│
│ Generated:
│   types: yes (5 min ago)
│   operations: yes (5 min ago)
│
│ Client files:
│   all present
╰──────────────────────────────────────────────────

If operations: no but types: yes, check for missing operationId values — those endpoints never make it into api.op.

Status breakdown

Config section

│ Config: api.config.toml
│   endpoint: http://localhost:3000/docs/swagger/json
│   output: app/services/api

Fresh config:

│ Config: api.config.toml (created)

Spec section

│ Spec:
│   cached: yes (hash: a1b2c3d4, 5 min ago)
│   endpoints: 42 total
│     GET: 18  POST: 12  PUT: 6  DELETE: 4  PATCH: 2

No cache yet:

│ Spec:
│   cached: no - run 'chowbea-axios fetch' first

Generated section

│ Generated:
│   types: yes (5 min ago)
│   operations: yes (5 min ago)

Not generated:

│ Generated:
│   types: no
│   operations: no

After fetch you should see api.contracts.ts alongside types and operations under _generated/.

Client files section

│ Client files:
│   all present

Partial setup:

│ Client files:
│   helpers: yes (2h ago)
│   instance: yes (2h ago)
│   error: missing
│   client: missing

Missing api.client.ts? Run init again or restore from scaffold. That's your import entrypoint (unless you renamed it).

Use cases

Verify setup

After init:

chowbea-axios status

Debug issues

chowbea-axios status --verbose

CI/CD verification

chowbea-axios status

Confirm generated output exists before the build step that imports api.contracts.ts.

status