culvii workspace create
Create a new workspace in the active org.
Synopsis
culvii workspace create --name <name> --slug <slug> [--env <env>]
Description
Creates a new workspace in the active org. Requires an OAuth session.
culvii dev also calls this internally to auto-provision a dev-{org-slug} workspace on first run. If the slug already exists, the existing workspace is returned — creation is idempotent.
Flags
| Flag | Required | Description |
|---|---|---|
--name | ✓ | Display name. Free text. |
--slug | ✓ | URL-safe identifier. Must match ^[a-z0-9][a-z0-9-]{0,62}$. Unique within the org. |
--env | — | Target environment. Defaults to active context. |
Examples
culvii workspace create --name "Payments" --slug payments
# → ✓ Workspace created successfully.
# → ID: uuid
# → Slug: payments
Error behaviour
| Condition | Message | Exit |
|---|---|---|
| Invalid slug format | 400 from server | 1 |
| Not authenticated | "Run culvii login first." | 1 |
Related commands
culvii workspace list, culvii dev