sase tmux-agent¶

Launch an interactive agent CLI in a new tmux window

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

usage: sase tmux-agent [-h] [-c <dir>] [-e <level>] [-j] [-l] [-n] [-r] [-s]
                       [-v]
                       [<provider>]

Launch an interactive agent CLI in a new tmux window. A bare sase tmux-agent paints a centered tmux display-menu of every registered agent CLI; choosing a row (or passing a provider) opens a new window in the current pane's directory. There is no list subcommand: a bare invocation must open the menu, because the tmux key binding (bind A run "sase tmux-agent") depends on that. Use -l|--list to print the catalog. --renumber is an internal hook invoked when an agent CLI window exits.

Options:

Option	Description	Default
`-c <dir>`, `--dir <dir>`	Launch directory (default: current tmux pane path, else $PWD)	—
`-n`, `--dry-run`	Print the window name, directory, env, and exact command; change nothing	`false`
`-e <level>`, `--effort <level>`	Explicit reasoning effort for this launch (off, none, minimal, low, medium, high, xhigh, max); unsupported levels are a usage error (choices: `high`, `low`, `max`, `medium`, `minimal`, `none`, `off`, `xhigh`)	—
`-h`, `--help`	show this help message and exit	—
`-j`, `--json`	Emit a versioned JSON envelope of the catalog or the dry-run plan	`false`
`-l`, `--list`	Print the catalog as a table; works outside tmux (not a subcommand)	`false`
`-r`, `--refresh`	Rebuild the catalog cache before doing anything else	`false`
`-s`, `--safe`	Launch without the provider's approval-bypass args	`false`
`-v`, `--verbose`	With --list, add resolved paths, full commands, and install hints	`false`

Arguments:

Argument	Description
`provider`	Provider to launch directly (omit to paint the tmux Agent menu)

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.