skystate show

Display the current remote config for an environment as JSON.

Synopsis

skystate show --env <slug>

Description

Fetches the latest config version for the linked project's specified environment and writes it as formatted JSON to stdout. A version header is written to stderr so the stdout output remains clean for piping.

The repo must already be linked via skystate init.

Options

Option	Description
--env <slug>	(Required) Environment to fetch. Accepts development, staging, or production.

Global options (--verbose, --api-url) are also accepted. See global options.

Note: --format and --quiet are not used by show; the output is always JSON to stdout.

Examples

# Show config for development
skystate show --env development

# Pipe into jq for querying
skystate show --env production | jq '.featureFlags.darkMode'

# Save to a local file
skystate show --env staging > staging-config.json

# Show while in verbose mode
skystate show --env development --verbose

Output

Version header on stderr:

my-app/development v1.2.3

Config JSON on stdout:

{
  "featureFlags": {
    "darkMode": true,
    "newCheckout": false
  },
  "limits": {
    "maxRetries": 3
  }
}

Because the version header goes to stderr and the JSON goes to stdout, piping works cleanly:

# Only the JSON goes into the pipe; the header still appears on screen
skystate show --env production | jq '.featureFlags'

Errors

Situation	Exit Code	Message
--env not specified	1	Error: No environment specified. with hint Use --env <slug>
Invalid environment	1	Error: Invalid environment "xyz". Must be one of: development, staging, production
No project linked	1	Error: No project linked. with hint Run: skystate init
No config pushed yet	—	No config found for my-app/development. Push config via the dashboard first. (exits 0)
Not authenticated	2	Not authenticated. Run: skystate login
Network error	1	Error: Network error -- check your connection and try again

Troubleshooting

• "No project linked" — run skystate init to link this repository to a project.
• "No config found" — no config has been pushed to that environment yet. Use skystate push or the dashboard to push an initial config.
• The command always fetches the latest version. There is no option to fetch a specific version from the CLI; use the dashboard for historical versions.

Dashboard equivalent

The Remote Config tab in the dashboard at https://app.skystate.io shows the current config for each environment with a visual diff viewer.