sase goal¶
Create, list, and reshape durable goal records
Reference for sase goal. Run sase goal --help for the exact output on this checkout.
usage: sase goal [-h] {doctor,drop,edit,list,merge,new,reopen,show} ...
Create, list, show, edit, drop, reopen, merge, and check durable goal records. With no subcommand, sase goal defaults to sase goal list. new, edit, drop, reopen, merge, and doctor --repair are human verbs: they refuse inside agent runs. Agents may run sase goal list and sase goal show.
Bare sase goal defaults to sase goal list.
Options:
| Option | Description | Default |
|---|---|---|
-h, --help |
show this help message and exit | — |
Subcommands:
| Subcommand | Summary |
|---|---|
sase goal doctor |
Check the goal ledger, optionally repairing markers |
sase goal drop |
Settle a goal as canceled |
sase goal edit |
Edit a goal's content |
sase goal list |
List goals (defaults to unsettled) |
sase goal merge |
Merge one goal into another |
sase goal new |
Create a goal |
sase goal reopen |
Reopen a settled goal |
sase goal show |
Show one goal card |
sase goal doctor¶
usage: sase goal doctor [-h] [-j] [-r]
Options:
| Option | Description | Default |
|---|---|---|
-h, --help |
show this help message and exit | — |
-j, --json |
Print the doctor report | false |
-r, --repair |
Repair markers and rebuild the projection (human only) | false |
sase goal drop¶
usage: sase goal drop [-h] -w WHY ID
Options:
| Option | Description | Default |
|---|---|---|
-h, --help |
show this help message and exit | — |
-w WHY, --why WHY |
Why the goal is dropped (required) | — |
Arguments:
| Argument | Description |
|---|---|
goal_id |
Goal id or ref |
sase goal edit¶
usage: sase goal edit [-h] [-c CRITERION] [-o OUTCOME] [-t TITLE]
[-x REMOVE_CRITERION]
ID
Options:
| Option | Description | Default |
|---|---|---|
-c CRITERION, --criterion CRITERION |
Add an acceptance criterion (repeatable) | — |
-h, --help |
show this help message and exit | — |
-o OUTCOME, --outcome OUTCOME |
Replacement outcome | — |
-x REMOVE_CRITERION, --remove-criterion REMOVE_CRITERION |
Remove a criterion by number as shown by sase goal show (repeatable) |
— |
-t TITLE, --title TITLE |
Replacement title | — |
Arguments:
| Argument | Description |
|---|---|
goal_id |
Goal id or ref |
sase goal list¶
usage: sase goal list [-h] [-a] [-f] [-j] [-n LIMIT]
[-s {active,all,done,dropped,review,settled,unsettled}]
Options:
| Option | Description | Default |
|---|---|---|
-a, --all-projects |
Render one section per enabled project | false |
-f, --fresh |
Integrate synchronously before reading | false |
-h, --help |
show this help message and exit | — |
-j, --json |
Print GoalListWire JSON | false |
-n LIMIT, --limit LIMIT |
Maximum goals shown | — |
-s STATUS, --status STATUS |
Status filter (default: unsettled). done, dropped, settled, and all scan history, newest first (choices: active, all, done, dropped, review, settled, unsettled) |
unsettled |
sase goal merge¶
usage: sase goal merge [-h] -i INTO [-w WHY] ID
Options:
| Option | Description | Default |
|---|---|---|
-h, --help |
show this help message and exit | — |
-i INTO, --into INTO |
Target goal id or ref (required) | — |
-w WHY, --why WHY |
Why the goals merge | — |
Arguments:
| Argument | Description |
|---|---|
goal_id |
Source goal id or ref |
sase goal new¶
usage: sase goal new [-h] -o OUTCOME -t TITLE [-c CRITERION]
Options:
| Option | Description | Default |
|---|---|---|
-c CRITERION, --criterion CRITERION |
Acceptance criterion (repeatable) | — |
-h, --help |
show this help message and exit | — |
-o OUTCOME, --outcome OUTCOME |
Goal outcome (required) | — |
-t TITLE, --title TITLE |
Goal title (required) | — |
sase goal reopen¶
usage: sase goal reopen [-h] -m MESSAGE ID
Options:
| Option | Description | Default |
|---|---|---|
-h, --help |
show this help message and exit | — |
-m MESSAGE, --message MESSAGE |
Why the goal reopens (required) | — |
Arguments:
| Argument | Description |
|---|---|
goal_id |
Goal id or ref |
sase goal show¶
usage: sase goal show [-h] [-j] ID
Options:
| Option | Description | Default |
|---|---|---|
-h, --help |
show this help message and exit | — |
-j, --json |
Print GoalStateWire JSON | false |
Arguments:
| Argument | Description |
|---|---|
goal_id |
Goal id or ref |
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.