Workspaces

A workspace is the project space where you keep services, sessions, skills, automations, and tasks. See Concepts → Workspace for the model.

Create a workspace

1. From the workspace hub or the org switcher, click New workspace.
2. Name the workspace.
3. Add one or more services:
   • Import a Git repo (GitHub / GitLab / Bitbucket via OAuth).
   • Pull a Docker Hub image.
   • Upload a folder.
   • Start empty.
   • Add a database from a template.
4. Confirm — you'll be dropped into the workbench on the default main session.

You can also use Auto-create from template for a one-click scaffold.

Switch workspaces

Use the workspace switcher in the header.

Add services later

Open the workspace's Settings → Services panel to import additional services, reorder them, or change their env vars and runtime limits.

Sessions inside a workspace

• Every workspace has a main session.
• Spin up new sessions from main for feature work; merge back when ready.
• Sessions own runtime state — see Concepts → Session.

Duplicate a workspace

There isn't a built-in Duplicate action yet. Workarounds:

• Create a new workspace pointing at the same Git services.
• Upload the same folder into a new workspace.

Best practices

• Keep main deployable; do feature work in feature sessions.
• Reuse the same Git service across multiple workspaces if you want parallel experiments.
• Archive workspaces you no longer need to keep the hub clean.