Skip to content
Kitsy Docs Open CNOS

cnos workspace

cnos workspace

Use cnos workspace when one CNOS root needs to serve more than one app or package.

Enable workspace mode

If the repo started with a flat .cnos/ tree:

Terminal window
cnos workspace enable

CNOS moves:

  • .cnos/values -> .cnos/workspaces/base/values
  • .cnos/secrets -> .cnos/workspaces/base/secrets
  • .cnos/env -> .cnos/workspaces/base/env
  • .cnos/profiles -> .cnos/workspaces/base/profiles

and updates the root anchor to workspace: base.

Add a workspace

Terminal window
cnos workspace add travel --package-root apps/travel

If base exists, the new workspace automatically gets extends: [base].

Override that when needed:

Terminal window
cnos workspace add api --extends shared
cnos workspace add sandbox --extends none

List and remove

Terminal window
cnos workspace list
cnos workspace remove gallery

Scaffold wording

If your team prefers scaffold wording:

Terminal window
cnos workspace scaffold insights --package-root apps/insights --extends base

Detach and attach

Terminal window
cnos workspace detach --package-root apps/travel
cnos workspace attach --package-root apps/travel

Detach makes a child package independent. Attach imports it back into the parent workspace model.