kite workspace¶

Manage development workspaces. Workspaces are persistent environments with code-server, terminal access, and port exposure.

Aliases: ws, w

create¶

Create a new workspace.

kite workspace create <name> [flags]

Flag	Description	Default
`--language`, `-l`	Programming language	`python`
`--cpu`	CPU limit	`1`
`--memory`	Memory limit	`2Gi`
`--disk`	Disk size	`10Gi`
`--timeout`	Execution timeout in seconds	`30`
`--github-repo`	GitHub repository to clone
`--github-branch`	Branch to clone	`main`
`--internet`	Enable internet access	`true`
`--require-gpu`	Require GPU	`false`

# Basic workspace
kite workspace create my-app -l python

# With custom resources
kite workspace create api -l node --cpu 2 --memory 4Gi

# Clone a repo on creation
kite workspace create backend -l go --github-repo github.com/user/repo

list¶

List workspaces in the current project.

kite workspace list [flags]

Flag	Description
`--all`, `-a`	Show all workspaces (including stopped)

get¶

Get workspace details.

kite workspace get <name-or-id>

start / stop¶

Start or stop a workspace.

kite workspace start <name-or-id>
kite workspace stop <name-or-id> [--timeout 30]

Flag	Description	Default
`--timeout`	Graceful shutdown timeout in seconds (stop only)	`30`

exec¶

Execute code in a workspace.

kite workspace exec <name-or-id> <code> [flags]

Flag	Description	Default
`--file`, `-f`	File to execute
`--timeout`, `-t`	Execution timeout in seconds	`30`
`--stream`, `-s`	Stream output in real-time	`false`

kite workspace exec my-app "print('hello')"
kite workspace exec my-app -f script.py
kite workspace exec my-app -f app.py --stream

ssh¶

Open an interactive shell in a workspace.

kite workspace ssh <name-or-id>

status¶

Get workspace status.

kite workspace status <name-or-id>

Port Management¶

expose-port¶

Expose a port from the workspace.

kite workspace expose-port <workspace-id> <port> [--public]

Flag	Description
`--public`	Make port publicly accessible without auth

unexpose-port¶

Remove an exposed port.

kite workspace unexpose-port <workspace-id> <port>

list-ports¶

List all exposed ports.

kite workspace list-ports <workspace-id>

delete¶

Delete a workspace.

kite workspace delete <name-or-id> [flags]

Flag	Description
`--yes`, `-y`	Skip confirmation
`--force`, `-f`	Force delete

Danger

Deleting a workspace is irreversible. All files and data inside will be lost.