sase workspace¶
Inspect and manage managed workspace checkouts
Reference for sase workspace. Run sase workspace --help for the exact output on this checkout.
usage: sase workspace [-h] {cleanup,compact,list,migrate,path,repair} ...
Bare sase workspace defaults to sase workspace list.
Options:
| Option | Description | Default |
|---|---|---|
-h, --help |
show this help message and exit | — |
Subcommands:
| Subcommand | Summary |
|---|---|
sase workspace cleanup |
Remove stale managed checkouts no longer claimed |
sase workspace compact |
Share and compact Git objects for safe managed checkouts |
sase workspace list |
List managed workspace checkouts (including primary #0) |
sase workspace migrate |
Migrate adjacent workspaces to a managed root |
sase workspace open |
— |
sase workspace path |
Print the checkout path for a workspace number |
sase workspace repair |
Reconcile the workspace registry with the filesystem |
sase workspace cleanup¶
usage: sase workspace cleanup [-h] [-p PROJECT] [-s] [-i] [-n]
Options:
| Option | Description | Default |
|---|---|---|
-n, --dry-run |
Report planned removals without touching the filesystem | false |
-h, --help |
show this help message and exit | — |
-i, --include-shares |
Also consider workflow-share managed checkouts for removal | false |
-p PROJECT, --project PROJECT |
Project to clean (default: infer from current directory) | — |
-s, --stale |
Remove unclaimed managed checkouts older than the configured TTL | false |
sase workspace compact¶
usage: sase workspace compact [-h] [-p PROJECT] [-n] [-j] [NUM ...]
Options:
| Option | Description | Default |
|---|---|---|
-n, --dry-run |
Report planned compactions without touching Git config or objects | false |
-h, --help |
show this help message and exit | — |
-j, --json |
Emit a machine-readable JSON object | false |
-p PROJECT, --project PROJECT |
Project to compact (default: infer from current directory) | — |
Arguments:
| Argument | Description |
|---|---|
workspace_nums |
Optional workspace number(s) to compact; default scans all numbered checkouts |
sase workspace list¶
usage: sase workspace list [-h] [-a] [-j] [-p PROJECT]
Options:
| Option | Description | Default |
|---|---|---|
-a, --all |
List registered workspaces across all enabled and disabled projects | false |
-h, --help |
show this help message and exit | — |
-j, --json |
Emit a machine-readable JSON object | false |
-p PROJECT, --project PROJECT |
Project to query (default: infer from current directory) | — |
sase workspace migrate¶
usage: sase workspace migrate [-h] [-p PROJECT] [-t {xdg-state}] [-s] [-f]
[-n]
Options:
| Option | Description | Default |
|---|---|---|
-n, --dry-run |
Report planned actions without touching the filesystem or registry | false |
-f, --finalize |
Remove transition symlinks left behind by a prior migration | false |
-h, --help |
show this help message and exit | — |
-p PROJECT, --project PROJECT |
Project to migrate (default: infer from current directory) | — |
-s, --symlink-transition |
Leave a ' |
false |
-t TO, --to TO |
Target root policy (currently only 'xdg-state' is supported) (choices: xdg-state) |
— |
sase workspace open¶
usage: sase workspace open [-h] [-p PROJECT] -r REASON [-P] [-c] workspace_num
Options:
| Option | Description | Default |
|---|---|---|
-c, --clean |
Prepare, clean, and update before printing (default; kept for compatibility) | false |
-h, --help |
show this help message and exit | — |
-P, --print |
Print the prepared path (default; kept for compatibility) | false |
-p PROJECT, --project PROJECT |
Project to query (default: infer from current directory) | — |
-r REASON, --reason REASON |
Non-empty reason for opening and preparing the workspace (required) | — |
Arguments:
| Argument | Description |
|---|---|
workspace_num |
Workspace number (0 = primary, 10+ = managed claims) |
sase workspace path¶
usage: sase workspace path [-h] [-p PROJECT] workspace_num
Options:
| Option | Description | Default |
|---|---|---|
-h, --help |
show this help message and exit | — |
-p PROJECT, --project PROJECT |
Project to query (default: infer from current directory) | — |
Arguments:
| Argument | Description |
|---|---|
workspace_num |
Workspace number (0 = primary, 10+ = managed claims) |
sase workspace repair¶
usage: sase workspace repair [-h] [-p PROJECT] [-n]
Options:
| Option | Description | Default |
|---|---|---|
-n, --dry-run |
Report planned changes without touching the filesystem or registry | false |
-h, --help |
show this help message and exit | — |
-p PROJECT, --project PROJECT |
Project to repair (default: infer from current directory) | — |
Related: CLI command groups.
_[project]: A sase project is a named unit of work registered with SASE. _[workspace]: A sase workspace is a numbered clone of a project's primary repo, managed by the workspace store and tracked in that project's registry.json. _[agent]: A sase agent is an agent session or a single agent that does not belong to a session. _[prompt]: A prompt is the text SASE hands to a provider to start an agent turn. _[macro]: A macro is a reusable prompt triggered with #name in agent prompts. _[Patch]: A Patch is SASE's local unit of change. _[bead]: A bead is one tracked work item in SASE's git-native issue tracker. _[plan]: A plan is a persisted, approved artifact recording the intent behind agent work. _[TUI]: The TUI is SASE's terminal interface for running agents and reviewing results. _[epic]: An epic is an executable multi-phase plan run with sase bead work. _[gate]: A sase gate is a durable, command-backed request for one user decision, created when work must pause for the user. _[monitor]: A sase monitor is a monitor turn that runs one long command under a detached supervisor, so the command outlives the agent that started it. *[stitch]: A stitch is the lightweight ordered change record inside a Patch's STITCHES: section.