sase macro

Expand and visualize macro workflows

Reference for sase macro. Run sase macro --help for the exact output on this checkout.

usage: sase macro [-h] {catalog,expand,explain,graph,list,show,types} ...

Bare sase macro defaults to sase macro list.

Options:

Option	Description	Default
-h, --help	show this help message and exit	—

Subcommands:

Subcommand	Summary
sase macro catalog	Render every visible macro to a beautifully-formatted PDF
sase macro expand	Expand sase references (snippets, file refs) in a prompt
sase macro explain	Dry-run: show execution plan without running anything
sase macro graph	Generate a DAG visualization of a workflow
sase macro list	List all available macros and workflows as JSON
sase macro show	Show one macro definition with syntax highlighting
sase macro types	List macro input types, including plugin-shared enums

sase macro catalog

usage: sase macro catalog [-h] [-o OUT_DIR]

Options:

Option	Description	Default
-h, --help	show this help message and exit	—
-o OUT_DIR, --out OUT_DIR	Directory to write the PDF (defaults to a tempdir).	—

sase macro expand

usage: sase macro expand [-h] [-t] [prompt]

Options:

Option	Description	Default
-h, --help	show this help message and exit	—
-t, --trace	Print expansion trace to stderr showing each resolved reference.	false

Arguments:

Argument	Description
prompt	Prompt text to expand. If not provided, reads from STDIN.

sase macro explain

usage: sase macro explain [-h] [-a KEY=VALUE] workflow_name [args ...]

Options:

Option	Description	Default
-a KEY=VALUE, --arg KEY=VALUE	Named argument (can be repeated).	—
-h, --help	show this help message and exit	—

Arguments:

Argument	Description
workflow_name	Workflow name to explain.
args	Positional arguments for the workflow.

sase macro graph

usage: sase macro graph [-h] [-f {mermaid,text}] [workflow_name]

Options:

Option	Description	Default
-f FORMAT, --format FORMAT	Output format (default: mermaid) (choices: mermaid, text)	mermaid
-h, --help	show this help message and exit	—

Arguments:

Argument	Description
workflow_name	Workflow name to graph. If not provided, lists all workflows.

sase macro list

usage: sase macro list [-h]

Options:

Option	Description	Default
-h, --help	show this help message and exit	—

sase macro show

usage: sase macro show [-h] [-c {auto,always,never}] [-f {full,json,raw}]
                       [-p PROJECT]
                       NAME

Show one macro or workflow definition: its declared properties, typed inputs, local helper macros, highlighted body, provenance, and the references it makes. The NAME argument accepts a bare name or a copied reference (#name, #!name, /name); arguments such as #name(a, b) are ignored with a note. --format json emits a versioned record and --format raw emits the exact definition source bytes.

Options:

Option	Description	Default
-c COLOR, --color COLOR	Color mode for rendered output (default: auto). (choices: always, auto, never)	auto
-f FORMAT, --format FORMAT	Output format (default: full). (choices: full, json, raw)	full
-h, --help	show this help message and exit	—
-p PROJECT, --project PROJECT	Resolve within a specific project namespace.	—

Arguments:

Argument	Description
name	Macro or workflow name, with optional copied reference marker.

sase macro types

usage: sase macro types [-h] [-j] [NAME]

List macro input types: scalar keywords, builtin domain types, and plugin-shared enums. With NAME, show one type's detail card.

Options:

Option	Description	Default
-h, --help	show this help message and exit	—
-j, --json	Print the Rust catalog projection as JSON.	false

Arguments:

Argument	Description
type_name	Type name, alias, or plugin-qualified name (e.g. effort, sase-research-artifacts@audio_edition).

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.