Commands
status
Show current state of your API client setup.
The status command displays a comprehensive overview of your chowbea-axios configuration, cached spec, and generated files.
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
╰──────────────────────────────────────────────────Status Breakdown
Config Section
Shows your configuration file location and key settings:
│ Config: api.config.toml
│ endpoint: http://localhost:3000/docs/swagger/json
│ output: app/services/apiIf the config was just created, you'll see (created):
│ Config: api.config.toml (created)Spec Section
Shows cache status and endpoint statistics:
│ Spec:
│ cached: yes (hash: a1b2c3d4, 5 min ago)
│ endpoints: 42 total
│ GET: 18 POST: 12 PUT: 6 DELETE: 4 PATCH: 2If no spec is cached:
│ Spec:
│ cached: no - run 'chowbea-axios fetch' firstGenerated Section
Shows the status of auto-generated files:
│ Generated:
│ types: yes (5 min ago)
│ operations: yes (5 min ago)Or if not generated:
│ Generated:
│ types: no
│ operations: noClient Files Section
Shows which editable client files exist:
│ Client files:
│ all presentIf some are missing:
│ Client files:
│ helpers: yes (2h ago)
│ instance: yes (2h ago)
│ error: missing
│ client: missingUse Cases
Verify Setup
After running init, check that everything was created:
chowbea-axios statusDebug Issues
If something isn't working, status shows the current state:
chowbea-axios status --verboseCI/CD Verification
Check that types are generated before building:
chowbea-axios status
# Check exit code or parse output