cc workspace

Usage

cc workspace [ACTION] [NAME] [flags]

Actions

Action	Description
`list`	Show all workspaces (default when no action given)
`add`	Create a new workspace
`edit`	Edit an existing workspace (name, path, R&D, remotes)
`open`	Open the workspace's version root in VS Code
`assign`	Assign a project to a workspace
`remove`	Delete a workspace

Flags

Flag	Description
`-n`, `--new`	Open in a new VS Code window (with `open`)

What is a Workspace?

A workspace groups projects under a single Odoo version. It provides:

Version binding — all projects in the workspace share the same Odoo version root
R&D branch checkout — workspaces with is_rnd enabled automatically checkout the environment's branch in shared Odoo repos (odoo, enterprise, design-themes, upgrade-util) on switch
Fork remote — R&D workspaces can define a fork remote for rebasing

cc setup automatically creates one workspace per registered version during the wizard. You don't need to create them manually unless you want multiple workspaces on the same version (e.g. one standard, one R&D).

R&D Mode

When a workspace has is_rnd = true:

On cc switch, CC checks out the environment's branch in all shared repos
Fetches from the fork remote
Rebases on the upstream version branch
Falls back to the upstream branch when the env branch doesn't exist
Rebase conflicts are auto-aborted with a warning

Configure with cc workspace edit <name> and set the R&D flag, fork remote, and upstream remote.

Examples

cc workspace
# → Lists all workspaces with version, path, R&D flag

cc workspace add
# → Interactive: name, version, path, R&D flag

cc workspace open 19
# → Opens VS Code at the v19 workspace root

cc workspace assign myproject
# → Assign a project to a workspace (interactive picker)

cc workspace edit 19
# → Edit workspace settings (name, R&D, remotes)

cc workspace remove old_ws
# → Delete a workspace

cc project add --workspace — create a project directly assigned to a workspace
cc switch — respects workspace R&D settings during branch checkout