Skip to main content

kapi workspace

List the workspaces you can access on a Bowrain server, or create a new team workspace. Requires authentication (run kapi auth login first).

Usage​

kapi workspace list
kapi workspace create --name "<name>" [--slug <slug>]

The server is resolved from --server, then BOWRAIN_SERVER_URL / server.url in bowrain.yaml, then your stored login, falling back to the hosted service (https://app.bowrain.cloud).

Subcommands​

list​

Lists every workspace your account can access, marking your personal workspace.

kapi workspace list

# Example output:
# alice (Alice) [personal]
# acme (Acme Corp)

Add --json for machine-readable output:

kapi workspace list --json

create​

Creates a new team workspace. The slug is derived from --name when --slug is omitted.

kapi workspace create --name "Acme Corp"
# Workspace created: acme-corp (Acme Corp)

kapi workspace create --name "Acme Corp" --slug acme
# Workspace created: acme (Acme Corp)

Flags​

FlagApplies toDescription
--serverbothServer URL (overrides config and stored login)
--namecreateWorkspace name (required)
--slugcreateURL-friendly slug (derived from --name if omitted)

Exit Codes​

  • 0 — Success
  • 1 — Error (not authenticated, server unreachable, slug conflict, …)
  • kapi auth — Authenticate before listing or creating workspaces
  • kapi init — Scaffolds a project and can select or create a workspace interactively