Getting started

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, then run the first observation.

Steps

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.

If a failure remains, report it and verify the fix, including this workflow and the failed step.