Slash Commands

Slash commands are command messages that start with /. In the TUI, commands are completed and grouped by the local command catalog plus the gateway command catalog. In messaging channels, only channel-supported commands are dispatched; ordinary text beginning with an unknown slash command is not treated as a hidden runtime operation.

Use /help in the TUI to list commands, or /help COMMAND to inspect one command's source, running behavior, surfaces, handler, audit category, and usage.

Surfaces And Busy Behavior

Surface	How commands are resolved
TUI	Local TUI commands are checked first, then gateway command metadata is used.
One-shot CLI	Shell commands are not slash commands; use anyy chat for prompts.
Messaging channels	The adapter dispatches only commands exposed for channel surfaces.
API/runtime clients	Commands are driven through gateway command descriptors.

Running behavior is part of each command descriptor:

Behavior	Meaning
local_only	Handled by the current surface without gateway execution.
bypass	Can run while a turn is active.
queue	Queues input behind the active turn.
steer	Adds guidance to the active turn.
reject_while_running	Refused until the active turn finishes or is stopped.

TUI Slash Commands

Local TUI commands are handled inside the terminal app:

Command	Purpose
/help [topic]	Show help or one command's detail.
/quit	Exit the TUI.
/new	Start a new session; confirms first if the current session has visible content.
`/compact on	off`
/resume [SESSION_ID]	Open the session picker or resume a specific session.
`/busy queue	steer
/copy	Copy the latest assistant response when clipboard support is available.
/paste	Show paste guidance for the current terminal.
`/details hidden	compact
`/reasoning show	hide
/fast	Show or switch fast model mode.
/logs	Show local TUI messages.
/insights	Show lightweight usage information.
/history	Show current session history.
/save	Export the current session to a file.
/branch [title]	Branch the current session.
/background <prompt>	Run a prompt in a background child agent.
/agents	Show child agents for the current session.
/jobs	Show background jobs for the current session.
/job <id> / /job kill <id>	Inspect or stop one background job.
/profile	Show active profile detail.
/config	Show active configuration.
/statusbar	Toggle the status bar.
/queue	Inspect or enqueue messages.
/redraw	Clear and redraw the terminal.
/undo	Undo the last exchange when no turn is running.
/retry	Retry the last user message when no turn is running.

The TUI also displays gateway commands that are available for the active surface. If a gateway command has the same name as a local command, the local command wins in the TUI.

Messaging Slash Commands

The runtime command registry exposes channel-capable commands to messaging adapters. Current built-ins with channel surfaces include:

Command	Purpose
/help	Show available commands.
/new	Start a new channel session.
/resume	Resume an existing session when supported by the surface.
/sessions	List recent sessions.
/status	Show runtime status.
/stop	Stop the running turn.
/queue	Queue input behind the running turn.
/btw	Add guidance to the running turn; /steer is an alias.
/retry	Retry the last failed turn.
/approve	Approve a pending request.
/deny	Deny a pending request.
/voice	Manage voice replies for a channel conversation.

Channel adapters can also expose dynamic skill commands. Those commands are resolved through the active skill catalog and are sent as session input with the skill content loaded for that turn.

Session Commands

Command	Behavior
/new	Creates a fresh session.
/resume [SESSION_ID]	Resumes a known session or opens a picker/list.
/sessions	Lists recent sessions.
/history	Shows messages from the current session.
/branch [title]	Creates a child session linked to the current session.
/compress	Compresses session context through the gateway.
/stop	Stops the running turn.
/queue <text>	Queues text while a turn is active.
/btw <text>	Steers the active turn with extra guidance.
/undo	Reverts the latest exchange.
/retry	Re-runs the last user message.

Some commands are rejected while a turn is running; others bypass the busy turn or intentionally queue/steer.

Model Commands

Command	Behavior
/model	Show the active model for the current session.
/model list	List models.
/model set ...	Change model scope when supported by the current runtime.
/provider	Inspect configured providers and provider auth.

The exact model/provider subcommands are parsed by the gateway command handler, not by the TUI. Use /help /model and /help /provider from the TUI for the currently loaded command metadata.

Cron Commands

Command	Behavior
/cron	Manage scheduled tasks through the runtime command handler.

Use the CLI reference for non-interactive cron management: CLI Commands.

Skill Commands

Command	Behavior
/skills	List available skills.
/skill	Show skill details.
/reload-skills	Reload skill metadata.
/tools	List available tools.
/toolsets	List available toolsets.
/mcp	Show MCP server and tool status.
/reload-mcp	Reload MCP server catalogs.

Dynamic skill commands are also possible when installed skills declare commands. They are scoped by the active profile, role, surface, and runtime visibility.

Runtime Management Commands

These built-ins are registered by the gateway command catalog. Availability can still vary by surface, profile configuration, and active runtime state.

Command	Behavior
/title	Show or set the current session title.
/goal	Set, inspect, pause, resume, or clear the session goal.
/changeplans	List pending or recent ChangePlans.
/plan	Show or update one ChangePlan.
/channels	Manage channel runtime state.
/weixin status	Show Weixin channel status.
/pair	Create a pairing request for supported channel flows.
/secrets	Manage secret references through the runtime handler.
/usage	Show provider and tool usage.
/logs	Show recent runtime logs.
/audit	Show audit events.
/doctor	Run runtime diagnostics.
/debug	Create a redacted debug bundle when no turn is running.
/footer	Toggle TUI footer detail where the local TUI supports it.