sky status

Display the current developer session, project API key, linked project, billing tier, and usage metrics in a single view.

Synopsis

bash

sky status [--format <table|json|plain>]

Description

sky status shows:

Account - token validity, token source, account name, email, account route identifier, subscription tier, project usage, API request usage, and Stored Users usage.
Api Key - API key validity, key source, key metadata, linked project, and API URL.

The command performs network calls in parallel to fetch account info, API key info, and billing status. If no token is stored, account fields show dashes. If no API key is set, API key fields show dashes. Usage rows (PROJECTS, API REQUESTS, STORED USERS) appear only when billing data is successfully fetched.

Output

Table output:

text

 Account
   TOKEN          eyJhbGciOi...
   TOKEN STATUS   valid (expires in 2h 30m)
   LOADED FROM    /home/user/.config/skystate/token.json
   CREATED        2026-03-15 10:30 UTC
   ACCOUNT        Jane Smith
   EMAIL          jane@example.com
   SLUG           acc_abc123
   TIER           hobby
   PROJECTS       4 / 7
   API REQUESTS   7,432 / 250,000 (resets Apr 1)
   STORED USERS   128 / 1,000 (0.3 MB)

 Api Key
   API KEY        sky_abc123...
   KEY STATUS     valid
   LOADED FROM    .env.local
   KEY CREATED    2026-03-10
   KEY EXPIRES    -
   PROJECT        my-app
   API URL        https://api.skystate.io

JSON output is a flat object:

json

{
  "auth_status": "ok",
  "token": "valid (expires in 2h 30m)",
  "token_prefix": "eyJhbGciOi...",
  "token_loaded_from": "/home/user/.config/skystate/token.json",
  "created": "2026-03-15 10:30 UTC",
  "account": "Jane Smith",
  "account_name": null,
  "account_slug": null,
  "email": "jane@example.com",
  "slug": "acc_abc123",
  "tier": "hobby",
  "api_key": "sky_abc123...",
  "key_status": "valid",
  "key_created": "2026-03-10T00:00:00Z",
  "key_expires": null,
  "key_loaded_from": ".env.local",
  "project": "my-app",
  "project_name": "My App",
  "api_url": "https://api.skystate.io",
  "projects_count": "4",
  "projects_limit": "7",
  "api_requests_count": "7432",
  "api_requests_limit": "250000",
  "api_requests_reset": "2026-04-01T00:00:00Z",
  "endUsersCount": "128",
  "endUsersLimit": "1000",
  "endUsersTotalSizeBytes": "300000"
}

Billing And Usage

There is no sky billing command. Billing is managed in the SkyState console, and CLI billing visibility comes from sky status.

When a developer token is present, sky status calls /v1/billing/status and renders:

project count and project limit
monthly API request count, limit, and reset date
Stored Users count, limit, and total stored size when the API returns that usage row
subscription tier on the account row

Use the console for subscription upgrades, invoices, billing portal access, and tier changes.

Token States

State	Meaning
`valid`	Token is present and the server confirmed it
`valid (expires in ...)`	Token verified with time until expiry
`unverified`	Token present but the server could not be reached to verify
`unverified (expires in ...)`	Unverified, with JWT-decoded expiry
`expired`	Token is present but has expired
`auth_failed`	Token was rejected by the server
no token	`TOKEN` and `TOKEN STATUS` display `-`

sky status ​

Synopsis ​

Description ​

Output ​