---
title: Bind a project to a workspace
description: Bind a project to a workspace.
canonical_url: https://orchestor.io/docs/en/cli/workflows/workspace-setup
markdown_url: https://orchestor.io/docs/en/cli/workflows/workspace-setup.md
contentType: how-to
---

# Bind a project to a workspace

Run the authenticated CLI from the intended project directory.

This saves a selection for an existing workspace. For a new target, [create a workspace](https://orchestor.io/docs/cli/workflows/new-workspace.md), then [run the first observation](https://orchestor.io/docs/cli/workflows/onboarding.md).

## Steps

```bash
orc workspaces list --json
orc workspace link WORKSPACE_ID
orc workspace current --json
orc brands list --workspace WORKSPACE_ID --json
```

`workspace link` writes `.orchestor/workspace.json` in the current directory. `workspace use WORKSPACE_ID` sets the user default. Resolution order is `--workspace` → `ORCHESTOR_WORKSPACE_ID` → directory binding → user default → server default. Check higher-priority values when the target differs. Run `orc workspace unlink` in the same directory to remove the binding, then inspect the remaining default with `orc workspace current --json`.

[Workflow index](https://orchestor.io/docs/cli/workflows.md) · [Setup reference](https://orchestor.io/docs/cli/setup.md)

If a failure remains, [report it and verify the fix](https://orchestor.io/docs/cli/workflows/workflow-feedback.md), including this workflow and the failed step.

---

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