Skip to content

Slash commands reference

Typing / triggers fuzzy autocomplete and discovery hints (see Input editor); the /help overlay lists registered commands live — if anything differs, trust /help.

Built-in commands

CommandAliasesArgumentsDescriptionSource
/quit/q /exitExit Blueblue-commands
/new/clearStart a new sessionblue-commands
/forkFork the current session into a new oneblue-commands
/sessions/resume<session-id>List persisted sessions and switch; an id resumes directlyblue-commands
/btw<question>Side question: fork the live session and askblue-pane-btw
/helpShow available commands and key bindingsblue-commands
/model[id]Switch the session model (no argument opens the picker)blue-model-commands
/effort/thinking[level]Switch the thinking effort (no argument opens the selector)blue-model-commands
/provider[list | switch <name> | add]List providers, switch the route, or add oneblue-model-commands
/preset[name]List agent presets or switch (blank sessions only)blue-preset-commands
/yolo/yes[on|off]Toggle auto-approval of tool calls (questions still pop)blue-mode-commands
/toolsList the tools visible to the current sessionblue-tools-commands
/skillsList available skills (the # prompt invokes one)blue-skills-command
/themesee ThemingList or switch themesblue-commands (via theme-switch)
/initAnalyze the codebase and write AGENTS.mdblue-session-init
/statusShow the session header, model, and context statusblue-commands
/contextShow token usage and the context windowblue-usage
/versionShow the Blue and harness versions and the live modelblue-commands
/export[path]Export the current session as a Markdown fileblue-session-export
/copyCopy the last assistant message to the clipboardblue-session-export

Sessions and models

  • /resume <session-id> — without an argument it returns usage: /resume <session-id>. /sessions offers a picker instead (newest first, the current session badged ← current).
  • /fork — returns cannot fork while the agent is running while the agent is not idle.
  • /model / /effort — no argument opens the model picker (with the footer's thinking-effort segment control) and the horizontal effort selector respectively; inside a panel step the segments and Alt+S confirms session-only — the next step's route switches immediately without persisting a new default. With an argument they switch directly and persist.
  • /provider — three subcommands: list shows providers and the current route; switch <name> switches; add starts the add-provider flow.
  • /preset — switches the agent composition over the thin-host preset roster (standard / code / minimal / cordis): a session's tool surface, persona, and plan mode come from its preset. Switching is allowed only on blank sessions — a started one returns cannot switch presets: this session has already started (blank sessions only).

Modes and approval

  • /yolo [on|off] — toggles yolo session mode; Shift+Tab cycles normal → plan → yolo at any time (see Session modes). Under yolo, tool calls are auto-approved while user questions still pop.
  • /init — the agent analyzes the codebase and writes AGENTS.md in the project root: if one exists it is read first, still-accurate content carries forward, and the file is rewritten into one coherent, up-to-date document (not appended), in the language the project's own docs mainly use.

Info and export

  • /export [path] — exports the current session as Markdown; without a path it writes the default filename blue-export-{id8}-{YYYYMMDD-HHMMSS}.md.
  • /copy — the last assistant message's text goes to the clipboard: OSC 52 first (the escape sequence travels over stdout to the local terminal emulator, so SSH sessions still reach the local clipboard), with a fallback pipeline behind it.
  • /theme — full usage usage: /theme [dark|light|auto|custom <path> [dark|light]], see Theming.
  • /quit — before the agent attaches it shows no active session (see the FAQ).

Commands never enter a model turn — success/error text flashes on the editor hint line. Commands registered by downstream plugins through ctx.commands appear automatically in the completion menu and /help; aliases are not registered as commands — the input layer rewrites them to the canonical name before dispatch (the kimi aliases port).

Preview · v0.1.0-rc.1