SkyState

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:

  • Auth - which credential serves each role. The ACCOUNT OPS row shows the credential used for account and developer commands, and the PROJECT OPS row shows the credential used for project data commands. Account ops always use your login. Project ops means the public-state commands: they use an API key when one is set and your login otherwise (see auth resolution). sky state user commands always use your login.
  • Login - token validity, token source, account name, email, account route identifier, subscription tier, project usage, API request usage, and end-user usage.
  • API key - API key validity, key source, key metadata, and linked project.

If no token is stored, login fields show dashes. If no API key is set, API key fields show dashes. Usage rows (PROJECTS, API REQUESTS, END USERS) appear only when a valid login is present and billing data is fetched successfully; END USERS additionally requires end-user usage in the billing data. The API URL shows on a single line at the end.

Output ​

Table output:

text
 Auth
   ACCOUNT OPS    login · Jane Smith
   PROJECT OPS    API key (.env.local) · sky_abc123...

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

 API key
   KEY            sky_abc123...
   STATUS         valid
   LOADED FROM    .env.local
   CREATED        2026-03-10
   EXPIRES        -
   PROJECT        my-app

 API URL          https://api.skystate.io

JSON output is a flat object with the same fields as the table: auth_status, account_ops, project_ops, the login fields (token, token_prefix, token_loaded_from, created, account, account_id, email, tier), the API key fields (api_key, key_status, key_created, key_expires, key_loaded_from, project, project_name), api_url, and, when billing data is available, the usage counts and limits for projects, API requests, and end users.