Workspace workflows

A Kestrel workspace is a durable catalog entry for a local project folder. The current directory is a discovery input; it is not the source of runtime configuration.

Inspect the current workspace

Bash

kestrel workspace status

Kestrel resolves the current directory, uses its Git root when available, and shows the matching catalog binding.

List registered workspaces

Bash

kestrel workspace list

Inside the interactive client, the equivalent commands are:

Text

/workspace status
/workspace list
/workspace use <workspaceId|rootPath|detached>

detached removes the active workspace binding for the session. Selecting a workspace does not copy, upload, or move its folder.

Profiles and scheduling

Profiles are selected through the normal CLI profile configuration; a workspace catalog entry does not contain a hidden profile override.

The catalog includes an automationEnabled field reserved for the scheduler. Current kcron commands can evaluate that field, but they do not execute workspace tasks. Enabled entries receive a deferred outcome until the central scheduler is implemented.

Read Profiles, code mode, and MCP for runtime configuration and kcron availability for the exact scheduling status.