---
title: open
description: Open the selected Workspace in the web app.
canonical_url: https://orchestor.io/docs/en/cli/open
markdown_url: https://orchestor.io/docs/en/cli/open.md
contentType: reference
---

# open

`orc open` opens the dashboard for the Workspace selected in the CLI in your default browser. Use it to inspect Workspace information and settings in the web app after working in the terminal.

CLI credentials and a selected Workspace are required. To link the current directory, run [`orc workspace link <workspace-id>`](https://orchestor.io/docs/cli/workspace.md). To set a default Workspace, run [`orc workspace use <workspace-id>`](https://orchestor.io/docs/cli/workspace.md). CLI credentials are not passed to the browser, so you may also need to sign in to the web app.

## Usage

```bash title="terminal"
orc open
```

*Open the selected Workspace dashboard in the default browser.*

Check the target Workspace with [`orc workspace current`](https://orchestor.io/docs/cli/workspace.md).

## How it works

`orc open` performs these steps:

1. Selects the target in this order: `--workspace`, `ORCHESTOR_WORKSPACE_ID`, `.orchestor/workspace.json` in the current directory, then the default Workspace in the active profile.
2. Checks the Workspace ID format and CLI credentials.
3. Selects the web app address in this order: `ORCHESTOR_WEB_URL`, the profile’s `webUrl`, then `https://orchestor.io`, and builds the `/w/<workspace-id>` URL.
4. Starts the system default browser and outputs the Workspace ID, selection source, URL, and launch result.

The default URL is `https://orchestor.io/w/<workspace-id>`. The CLI builds the URL from local selection information. Sign-in to the web app and Workspace access checks take place in the browser. The launch result indicates that the browser launch was accepted; it does not verify that the page finished loading.

## Examples

### Open from a linked directory

Run the command in a directory linked to a Workspace. If `--workspace` and `ORCHESTOR_WORKSPACE_ID` are not set, the directory link is used.

```bash title="terminal"
orc open
```

*Open from a linked directory*

Opens the target Workspace dashboard in the default browser.

### Specify a Workspace to open

```bash title="terminal"
orc open --workspace <workspace-id>
```

*Specify a Workspace to open*

### Inspect the URL without starting the browser

```bash title="terminal"
orc open --dry-run --json
```

*Inspect the URL without starting the browser*

Checks the Workspace and credentials, then displays the target URL as JSON. Does not start the browser.

## Troubleshooting

### No Workspace selected

If `No Workspace selected.` appears, change to the target directory and link the Workspace before opening it.

```bash title="terminal"
orc workspace link <workspace-id>
orc open
```

*Link a Workspace to the current directory and open its dashboard.*

To use a default Workspace regardless of the directory, configure it as follows.

```bash title="terminal"
orc workspace use <workspace-id>
orc open
```

*Set the default Workspace and open its dashboard.*

If the wrong Workspace opens, check the selection source with `orc workspace current`. `--workspace` and `ORCHESTOR_WORKSPACE_ID` take precedence over the directory link and default settings.

### Missing credentials

If `Not authenticated.` appears, sign in with `orc auth login`. If the browser displays a sign-in page, also sign in to the web app.

### Browser could not start

If `Could not start the default browser.` appears, manually open the URL in the error instructions or configure the system default browser.

### Invalid Workspace ID or web app URL

Use letters, numbers, `_`, and `-` in Workspace IDs. Set the web app address to an HTTP or HTTPS URL without embedded credentials. Check `ORCHESTOR_WEB_URL` and `webUrl` in the active profile.

## Global Options

The following [global options](https://orchestor.io/docs/cli/global-flags.md) can be used with `orc open`:

- [`--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)
- [`--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)

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

## Related

- [`orc workspace link`](https://orchestor.io/docs/cli/workspace.md) — Link a Workspace to the current directory.
- [`orc workspace use`](https://orchestor.io/docs/cli/workspace.md) — Set the default Workspace.
- [`orc workspace current`](https://orchestor.io/docs/cli/workspace.md) — Check the selected Workspace and selection source.
- [Global options](https://orchestor.io/docs/cli/global-flags.md)

---

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