status
At-a-glance budget usage and provider health for a Solwyn project
status reads a project's budget summary and provider health in one call — spend against limit, and per-provider circuit state, success rate, latency, errors, and failovers. It never reserves or authorizes spend; it is a pure read.
solwyn --project <project_id> statusResolve the project with --project, the SOLWYN_PROJECT_ID environment variable, or a default_project in your config file — in that order. This command takes no options of its own beyond the global flags.
| Contract | |
|---|---|
| Auth | any (project key or JWT) |
| Exit codes | 0 success · 1 generic/API · 2 usage · 3 auth · 5 not found |
| JSON schema | solwyn.status.v1 |
Output
The human table lists the budget summary, then a block of rows per provider:
$ solwyn --project proj_abc12345 status
Field Value
Project proj_abc12345
Budget limit 100.00
Current usage 23.47
Remaining budget 76.53
Budget period monthly (2026-07)
Budget mode alert_only
Utilization 23.47%
openai circuit closed
openai success 1202 / 1204 (99.83%)
openai latency 342.10 ms
openai errors / failovers 2 / 0
anthropic circuit closed
anthropic success 387 / 387 (100.00%)
anthropic latency 518.40 ms
anthropic errors / failovers 0 / 0| Field | Meaning |
|---|---|
| Budget limit / Current usage / Remaining budget | Spend against the cap for the current period, in USD |
| Budget period | daily, weekly, or monthly, with the period key |
| Budget mode | alert_only or hard_deny |
| Utilization | Spend as a percentage of the limit |
<provider> circuit | Failover circuit state for the provider |
<provider> success | Successful calls over total, with success rate |
<provider> latency | Average end-to-end latency in milliseconds |
<provider> errors / failovers | Error count and times traffic moved to a fallback |
Only quantities and structural labels are read — counts, rates, durations, and circuit states — never prompt or response content. See Privacy for the full boundary.
JSON output
$ solwyn --project proj_abc12345 --json status
{
"schema": "solwyn.status.v1",
"project_id": "proj_abc12345",
"budget": {
"budget_limit": 100.0,
"current_usage": 23.47,
"remaining_budget": 76.53,
"budget_period": "monthly",
"budget_mode": "alert_only",
"period_date": "2026-07",
"utilization_pct": 23.47
},
"providers": [
{
"provider": "openai",
"total_calls": 1204,
"success_count": 1202,
"error_count": 2,
"failover_count": 0,
"success_rate": 99.83,
"avg_latency_ms": 342.1,
"circuit_state": "closed"
}
]
}Pretty-printed here; the CLI emits the envelope as a single line. See Scripting for the envelope and exit-code contract.
Related
budget status— budget state alone, with an optional CI utilization gatecosts— aggregate cost breakdown by model, provider, or day- Provider failover — how the SDK routes around a failing provider