Updated Edit
On this page
Start the TUI launcher or preset segments via flags; supports session resume by UUID or title, and print mode.
#c launch
start the interactive TUI launcher to select a profile, model, and directory
Effect: mutating
#Flags
| Name | Short | Type | Presence | Env | Description |
|---|---|---|---|---|---|
session | choice | default: {"choice": "new-session"} | Selection (not typed as a flag). Elect exactly one of --cont, --resume, --print-prompt, --picker, --new-session. which session this launch starts in | ||
--cont | required | Elects session = cont. continue the most recent conversation in the current directory | |||
--resume | str | required | Elects session = resume. resume one specific session Its value: session to resume, by UUID or by title; an empty string opens Claude Code's own picker | ||
--print-prompt | str | required | Elects session = print-prompt. run one prompt in non-interactive print mode and exit Its value: the prompt to run non-interactively | ||
--picker | required | Elects session = picker. browse this profile's sessions and pick one to resume | |||
--new-session | required | Elects session = new-session. start a new session (what a bare launch does) | |||
--profile | str | optional | preset the Profile segment to this value, skipping TUI selection for it | ||
--github | str | optional | preset the GitHub account segment to this value, skipping TUI selection for it | ||
--model | str | optional | preset the Model segment to this value (e.g. opus, sonnet), skipping TUI selection | ||
--directory | str | optional | preset the Directory segment to this path, skipping TUI selection for it | ||
--mcp | str | optional | preset the MCP mode segment to this value, skipping TUI selection for it | ||
--permissions | str | optional | preset the Permissions segment to this value, skipping TUI selection for it | ||
--set | -s | list[str] | default: [] | set any segment value as KEY=VALUE (e.g. -s version=2.1.119); repeatable | |
--client | str | optional | launch target client (one of: claude, miniclaude). When omitted, the interactive launcher prompts with a Client step (cursor on config default_client, else claude) and non-interactive launches use default_client. Passing it explicitly skips that step. 'miniclaude' launches the miniclaude REPL instead; version and strict-MCP selections, config default_flags, and the disallowedTools list are claude-client-only |
Flag sets:
segments----profile,--github,--model,--directory,--mcp,--permissions,--setclient----client
#Grants
| Kind | Name | Reason |
|---|---|---|
| proc_mutate | exec-client | the launcher replaces this process with the selected client binary |