---
title: status
description: Diagnose authentication, connectivity, Workspace selection, and CLI
  installation.
canonical_url: https://orchestor.io/docs/en/cli/status
markdown_url: https://orchestor.io/docs/en/cli/status.md
contentType: reference
---

# 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`](https://orchestor.io/docs/cli/whoami.md) for account details or [`orc auth status`](https://orchestor.io/docs/cli/auth.md) to verify credentials alone.

## Usage

```bash title="terminal"
orc status
```

*Diagnose the running CLI and connection.*

Compatibility aliases: `orc account status`.

## Examples

### Retrieve diagnostics as JSON.

```bash title="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`](https://orchestor.io/docs/cli/auth.md) 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](https://orchestor.io/docs/cli/global-flags.md) can be used with `orc status`:

- [`--help`](https://orchestor.io/docs/cli/global-flags.md#help)
- [`--workspace`](https://orchestor.io/docs/cli/global-flags.md#workspace)
- [`--json`](https://orchestor.io/docs/cli/global-flags.md#json-output)
- [`--pretty`](https://orchestor.io/docs/cli/global-flags.md#json-output)
- [`--format`](https://orchestor.io/docs/cli/global-flags.md#output-format)
- [`--field`](https://orchestor.io/docs/cli/global-flags.md#field-selection)
- [`--fields`](https://orchestor.io/docs/cli/global-flags.md#field-selection)
- [`--raw`](https://orchestor.io/docs/cli/global-flags.md#raw-output)
- [`--output`](https://orchestor.io/docs/cli/global-flags.md#file-output)
- [`--no-pager`](https://orchestor.io/docs/cli/global-flags.md#pager)
- [`--dry-run`](https://orchestor.io/docs/cli/global-flags.md#dry-run)
- [`--yes`](https://orchestor.io/docs/cli/global-flags.md#confirmation)
- [`--stdin`](https://orchestor.io/docs/cli/global-flags.md#standard-input)
- [`--from-stdin`](https://orchestor.io/docs/cli/global-flags.md#standard-input)
- [`--page-all`](https://orchestor.io/docs/cli/global-flags.md#all-pages)
- [`--timing`](https://orchestor.io/docs/cli/global-flags.md#request-timing)
- [`--readonly`](https://orchestor.io/docs/cli/global-flags.md#read-only-mode)
- [`--wrap-untrusted`](https://orchestor.io/docs/cli/global-flags.md#untrusted-content-wrapping)

For details and examples, see [global options](https://orchestor.io/docs/cli/global-flags.md).

---

[Documentation index](https://orchestor.io/docs/llms.txt)