sase tui¶

Open sase's TUI for agents, Patches, artifacts, notifications, and Services

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

usage: sase tui [-h] [-m {large,small}] [-M {big,little}] [-p [PROFILE]]
                [-r REFRESH_INTERVAL] [-R] [-s SANITY_REFRESH_INTERVAL]
                [-t {artifacts,changespecs,patches,agents,services,axe}] [-T]
                [-x] [-v {git,hg,auto}]
                [query]

Options:

Option	Description	Default
`-h`, `--help`	show this help message and exit	—
`-M MODEL_SIZE`, `--model-size MODEL_SIZE`	Deprecated: use --model-tier instead (choices: `big`, `little`)	—
`-m MODEL_TIER`, `--model-tier MODEL_TIER`	Override model tier for ALL LLM provider instances (large or small) (choices: `large`, `small`)	—
`-x`, `--no-service`, `--no-axe`	Disable auto-starting the service host on startup	`false`
`-p PROFILE`, `--profile PROFILE`	Profile the TUI session with pyinstrument. Optionally provide a file path for the output (default: $SASE_TMPDIR/ace_profile_.txt)	—
`-r REFRESH_INTERVAL`, `--refresh-interval REFRESH_INTERVAL`	Auto-refresh interval in seconds (default: 10, 0 to disable)	`10`
`-R`, `--restart-service`, `--restart-axe`	Restart the service host on startup (no-op if it is not running)	`false`
`-s SANITY_REFRESH_INTERVAL`, `--sanity-refresh-interval SANITY_REFRESH_INTERVAL`	Full sanity-refresh interval in seconds (default: 300). Missed watcher or token changes are still reconciled at least this often.	`300`
`-t TAB`, `--tab TAB`	Tab to focus on startup; 'services' is the Services tab ('axe' remains a legacy alias), and 'changespecs'/'patches' remain legacy aliases for 'artifacts' (default: agents) (choices: `agents`, `artifacts`, `axe`, `changespecs`, `patches`, `services`)	`agents`
`-T`, `--tmux`	Launch the TUI in a new tmux window named 'sase_tmux_' and print its session/window target on stdout. Useful for agents that need to drive the TUI via 'tmux send-keys' and observe it via 'tmux capture-pane'.	`false`
`-v VCS_PROVIDER`, `--vcs-provider VCS_PROVIDER`	Override VCS provider ('git', 'hg', or 'auto' for auto-detection) (choices: `auto`, `git`, `hg`)	—

Arguments:

Argument	Description
`query`	Query string for filtering Patches (default: last used Patches query, first saved Patches query, or '!!!' for error suffixes). Examples: '"feature" AND "Ready"', '"myproject" OR "bugfix"', '!!! AND @myproject'

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.