CLI Reference¶
This page is a command index for the top-level sase CLI. It is meant for discovery and routing: use it to find the
surface that owns a workflow, then follow the links to the detailed command, flag, or subsystem reference.
For exhaustive flag tables, see the configuration reference.
Daily Operation¶
| Command | Purpose | Details |
|---|---|---|
sase ace |
Open ACE, the interactive control surface for ChangeSpecs, live agents, notifications, and axe state. | ACE TUI |
sase run [PROMPT] |
Launch an agent or workflow from a prompt, an xprompt reference, a workflow reference, history, or an editor buffer. | XPrompts, workflows |
sase agents status |
List active and recent agents across projects. | ACE Agents tab |
sase agents show |
Render one agent's detail panel by name, timestamp, or path. | Agent attachments |
sase agents kill |
Terminate a running agent. | ACE TUI |
sase agents tag |
Set, clear, or list user-defined agent tags used for grouping. | ACE TUI |
sase chats list |
List recent chat transcripts. | XPrompts |
sase chats show |
Show one chat transcript by agent name, path, or basename. | XPrompts |
sase notify / sase notify create |
Create a notification from JSON input. | Notifications |
sase notify list |
List recent notifications, optionally filtered by sender, unread state, or query. | Notifications |
sase notify show |
Show one notification as Markdown or JSON. | Notifications |
sase run can run in the foreground, launch detached background agents with --daemon, resume previous conversations,
or expand multi-prompt input into sequential background launches. ACE uses the same launch machinery when users start
agents from the TUI.
Work Tracking And Planning¶
| Command | Purpose | Details |
|---|---|---|
sase changespec current |
Render the ChangeSpec associated with the current workspace. | ChangeSpecs |
sase changespec search |
Search and filter ChangeSpecs with the query language. | Query language |
sase changespec sync-deltas |
Recompute the DELTAS field for a ChangeSpec from VCS state. |
ChangeSpecs |
sase sdd init |
Create or refresh SDD README files and directory map assets. | SDD |
sase sdd list |
List SDD prompt, tale, epic, legend, or all Markdown artifacts. | SDD |
sase sdd links |
Inspect prompt/artifact frontmatter links. | SDD |
sase sdd validate |
Validate SDD frontmatter links. | SDD |
sase sdd repair-links |
Infer and optionally write missing bidirectional SDD links. | SDD |
sase bead onboard |
Print the bead quick-start guide. | Beads |
sase bead init |
Initialize bead storage for the current project. | Beads |
sase bead create |
Create plan, epic, legend, or phase issues. | Beads |
sase bead list |
List bead issues by status, type, or tier. | Beads |
sase bead ready |
Show open issues whose dependencies are closed. | Beads |
sase bead blocked |
Show issues blocked by open dependencies. | Beads |
sase bead show |
Show one issue. | Beads |
sase bead update / open / close / rm |
Mutate issue metadata or lifecycle state. | Beads |
sase bead dep add |
Add an issue dependency. | Beads |
sase bead sync |
Export the bead database to git-tracked JSONL and stage it. | Beads |
sase bead stats / doctor |
Inspect project statistics or bead-store health. | Beads |
sase bead work |
Launch phase agents for an epic, or epic-planning agents for a legend. | Beads |
sase plan |
Submit a plan for approval from the plan skill path. | XPrompt directives |
sase questions |
Ask structured user questions from the questions skill path. | XPrompt directives |
ChangeSpecs are CL/PR-sized review records. SDD stores durable prompt and planning artifacts. Beads add git-portable dependency tracking and executable epics on top of those artifacts.
Automation¶
| Command | Purpose | Details |
|---|---|---|
sase axe start |
Start the axe orchestrator and its lumberjacks. | Axe |
sase axe stop |
Stop the running orchestrator. | Axe |
sase axe chop list |
List configured chop jobs. | Axe chops |
sase axe chop run <name> |
Run one chop in the foreground. | Axe chops |
sase axe lumberjack list |
List configured lumberjacks. | Axe lumberjacks |
sase axe lumberjack run <name> |
Run one lumberjack in the foreground for debugging. | Axe lumberjacks |
sase axe lumberjack status |
Show lumberjack process status. | Axe |
sase axe maintenance enter |
Pause scheduled lumberjack ticks with a recorded reason. | Maintenance mode |
sase axe maintenance exit |
Resume scheduled lumberjack ticks. | Maintenance mode |
sase axe maintenance status |
Inspect the maintenance marker. | Maintenance mode |
Axe runs scheduled hooks, mentors, comment polling, workflow checks, %wait dependency resolution, cleanup, and error
digests. ACE starts axe automatically unless launched with sase ace --no-axe.
Prompt And Workflow Authoring¶
| Command | Purpose | Details |
|---|---|---|
sase xprompt expand |
Expand xprompt references in prompt text, with optional trace output. | XPrompt reference syntax |
sase xprompt explain |
Dry-run a workflow and show the execution plan. | Workflows |
sase xprompt list |
Emit the structured xprompt catalog as JSON. | XPrompt catalog |
sase xprompt graph |
Generate a workflow DAG as Mermaid or text. | Workflow graphing |
sase xprompt catalog |
Render visible xprompts to a formatted PDF catalog. | XPrompt catalog |
sase lsp |
Start the xprompt language server over stdio. | Editor LSP |
sase editor helper-bridge |
JSON helper operations for editor integrations. | Configuration CLI flags |
sase file list |
Emit JSON filesystem completion candidates. | Editor completion commands |
sase file-history list |
Emit recently referenced files for editor completion. | Editor completion commands |
sase file-history delete |
Remove one path from the file-reference history. | Editor completion commands |
sase init-skills |
Generate and deploy agent skill files from xprompt source templates. | Bundled skills |
Use #name(...) for inline xprompt expansion and #!workflow(...) for standalone workflow references. Workspace
references such as #cd:<path>, #git:<project>, and plugin-provided references are resolved before the prompt or
workflow runs.
Review And Delivery¶
| Command | Purpose | Details |
|---|---|---|
sase commit |
Dispatch a commit, proposal, or PR through the configured VCS provider. | Commit workflows |
sase revert |
Revert a ChangeSpec by pruning its change and archiving its diff. | Commit workflows |
sase restore |
Restore a reverted ChangeSpec by reapplying its archived diff. | Commit workflows |
sase comments |
Preview mentor comments from JSON with syntax-highlighted code context. | Mentors |
Delivery commands delegate to the VCS and workspace provider layers, so the same command surface can support plain git, GitHub pull requests, and other provider plugins.
Operations And Diagnostics¶
| Command | Purpose | Details |
|---|---|---|
sase config layers |
Show the configuration merge chain. | Configuration |
sase config show |
Dump the final merged configuration, optionally filtered by key. | Configuration |
sase config mentor-match |
Trace mentor profile matching for a ChangeSpec. | Mentors |
sase core health |
Check that the required sase_core_rs extension is loadable and working. |
Rust backend |
sase telemetry status |
Show telemetry configuration and reachability. | Telemetry |
sase telemetry list |
Display the metric catalog. | Telemetry |
sase telemetry snapshot |
Fetch current metric values. | Telemetry |
sase telemetry dashboard |
Open the live telemetry dashboard. | Telemetry |
sase telemetry health |
Run subsystem health assessment. | Telemetry |
sase telemetry export-config |
Export the bundled monitoring stack. | Telemetry |
sase logs |
Collect and package agent run logs for a date range. | Configuration CLI flags |
sase artifact create |
Move an explicit file into persistent agent artifact storage. | Agent attachments |
sase path |
Print well-known paths such as schemas and xprompt directories. | Configuration CLI flags |
sase init-git |
Initialize a bare-repo-backed git project. | ProjectSpec |
sase mobile gateway start |
Start the workstation-hosted mobile gateway. | Mobile gateway |
sase mobile agent-bridge |
Fixed JSON bridge used by the mobile gateway for agent operations. | Mobile gateway |
sase mobile helper-bridge |
Fixed JSON bridge used by the mobile gateway for workflow helper operations. | Mobile gateway |
Operational commands are intentionally narrow. Helper bridges expose fixed JSON operations for editor and mobile clients; they are not general shell or filesystem APIs.