TUI¶

Reference facts for the sase TUI, one page per surface. Guides teach workflows.

Overview¶

sase's TUI is the primary TUI for the SASE toolkit. It provides an interactive interface for navigating, managing, and operating on Patches, agents, and machine services.

Start and layout¶

Launching — start the TUI, screenshots, clipboard.
Tabs and panes — tabs, Artifacts panes, navigation.
Filtering — Agents, Patches, Commits, Beads, Plans.
Files and preview — Files, Preview, Archive.
Artifacts tab — links, Patches keys, PR chips.
SASE Admin Center — Config, Logs, Machines, Procs.

Agents tab¶

Agents tab — tabs, keys, lists, actions.
Agents tab search and modes — search and key modes.
Agents tab panels — clan, session, tribe.
Agents tab grouping — banners and modes.
Agent row glyphs — glyphs, markers, badges.
Agent statuses — wait and completion.
Agents tab main deck — deck, zoom, node rail.
Agents tab LLM calls and tool runs — call and run panels.
Agent workflows — plans, approvals, holds.

Prompt and launch¶

Prompt input — insert mode, alt-brace, macros.
Prompt modes — NORMAL and Visual keys.
Prompt stacks — panes, stash, trash.
Prompt completion — tokens and next-word prediction.
Prompt completion panels — glossary, memory, snippets.
Prompts overlay — History, Stash, Trash.
Snippets — expansion and Macro Browser.
Launch Control — usage, effort, capacity, routing.
Launch Control overrides — temporary and persistent.

Other tabs and controls¶

Services tab — sidebar, jobs, keys.
Procs tab — durable procs and monitors.
Updates tab — core, plugins, agent CLIs.
Projects tab — add, initialize, current project.
Machines, statistics, and tools — Machines, Statistics, Tools.
Query system — edit, save, recall.
Global controls — keys, palette, command line.
Notifications modal — modal, snooze, toasts.
Finders — Jump All and Node Finder.
SASE Pager — artifact and file pager.

TUI keymaps — generated keymap defaults.
TUI rendering — tab bar and previews.
TUI migration notes — command name, aliases, and stored layouts.
Reference — lookup pages.

_[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.