Basics

status

orc status reports credentials, the API origin, organization, selected Workspace, and installation details for the running CLI. It verifies credentials and checks API health as well as local configuration to help diagnose connectivity and setup problems.

Credential secrets are not displayed. Use orc whoami for account details or orc auth status to verify credentials alone.

Usage

terminal
orc status

Diagnose the running CLI and connection.

Compatibility aliases: orc account status.

Examples

Retrieve diagnostics as JSON.

terminal
orc status --json

Retrieve diagnostics as JSON.

Installation details

The installation object includes install_owner (native, brew, winget, npm, or unknown), exec_path, and the running version. If multiple CLI installations exist, check that the expected executable is running.

Reading diagnostics

Authenticate again with orc auth login if credentials are missing or invalid. Workspace selection uses --workspace, ORCHESTOR_WORKSPACE_ID, the directory link, then global configuration. Check higher-priority settings when an unexpected target is selected.

If the API is unreachable, check the API URL and runtime environment. Completion of the diagnostic command does not mean every item is healthy; read each state and its explanation.

Global Options

The following global options can be used with orc status:

For details and examples, see global options.