Skip to content

Slash Commands

KodaCode exposes a small runtime-owned command surface from the composer. Most entries are slash commands. The !<command> form is a direct composer action for local shell execution. These commands change session state, open management dialogs, inspect stored runtime data, or start an explicit user execution turn. They are not prompt tricks; they call explicit product behavior.

CommandUse it forNotes
/paletteOpen the root command paletteGood starting point when you do not remember a shortcut
/initCreate workspace instruction filesWrites AGENTS.md only when missing, and may also create CLAUDE.md for Anthropic routes; see Project Memory & Instructions
/compressCompress workspace instructions and project memoryRewrites existing AGENTS.md and .kodacode/memories/*.md through the utility-model path
/compactRebuild the saved history summary nowUses the same history-compaction path as automatic runtime compaction
/newStart a new sessionLeaves the current session intact
/historySearch recent promptsOpens the same searchable history surface as Ctrl+R; separate from inline Up / Down recall
/review [instructions]Run a one-off runtime reviewUses the reviewer agent path, defaults to current workspace changes, and leaves your selected agent unchanged
/workflow [id|off|resume]Select, clear, or resume a runtime workflowWithout an argument, opens the workflow picker; off clears the selection; resume continues a blocked workflow
!<command>Run a local shell command from the composerUser-initiated execution path; uses the same runtime execution, approval, and event model
/modelSwitch modelChanges the active model route
/utility-modelSelect utility modelSets or unsets the cheaper utility route used for runtime text work
/reviewer-modelSelect reviewer modelSets or unsets the reviewer route used by review turns
/variantChoose provider reasoning effortAvailability depends on the selected model and tool setup
/thinkingToggle provider thinking outputAvailability depends on provider support
/themeSwitch themeTUI-only presentation setting
/connectConnect or configure a providerFastest path to initial provider setup
/trustManage trust for the current workspaceCovers workspace trust and MCP trust entries
/costInspect session costShows spend, savings, and cache/cost detail
/timelineNavigate session timeline and branchesLists turns plus nested branch sessions with tree glyphs and previews; search, filter, fold, label branches, open a branch row, or create a branch from a completed turn
/trace [turn-number]Inspect one turnOpen without an argument to inspect the session turn index
/restore [turn-number]Restore writes from one turn in the current sessionOpen the session that owns the turn first
/quitExit KodaCodeEnds the current app process
  • /palette: open the command palette
  • /init: create workspace instruction files
  • /compress: compress AGENTS.md and project memory
  • /compact: rebuild older session history into the saved History Summary now
  • /new: start a new session
  • /history: search recent prompts through the searchable history popup
  • /timeline: branch a new session from a completed previous turn
  • /review [instructions]: run a focused runtime-owned review of the current workspace changes
  • /workflow [id|off|resume]: select a runtime workflow, clear it, or resume a blocked workflow
  • Ctrl+W: list available runtime workflows or select one for later turns

Use this group when you want to branch from prior work, inspect turns, or prepare the current session before another turn.

/timeline is for trying another path without losing the original session. It lists the current session’s turns, shows parent and nested child branch sessions with tree glyphs, lets you inspect a turn with t, and creates a new session from the selected completed turn with Enter or b. Branch rows preview status, update age, parent turn, session id, child branch count, and any fresh saved branch summary. Use / to search, f or 1 through 5 to filter, Space / Left / Right to fold branch subtrees, s to explicitly summarize a child branch with the configured utility model, and e to label a branch session. Opening Timeline does not generate summaries. Running turns can be selected for inspection, but only completed turns can be branched.

/compact only affects stored session history. It calls the same history-compaction path used by automatic compaction instead of creating a separate manual workflow.

/review is the exception in this group: it is a repository-work command, but it lives beside session controls because it is an explicit TUI action rather than a prompt convention. It starts a one-off runtime-owned review, defaults to the current workspace changes, uses the configured review model when available, and leaves your selected default agent unchanged for later turns. Review behavior is guided by the active reviewer agent definition, so you can tune it with a global or project-local reviewer.md override while runtime keeps the review scope and structured output format authoritative.

/workflow and Ctrl+W both open the workflow dialog. Use them to choose delivery, debug, review, explore, or a project-defined workflow for later turns in the current session. /workflow delivery selects a workflow by ID, /workflow off clears the current selection, and /workflow resume continues a blocked workflow phase when one exists. Selected workflow state, active phase, blocked reason, and evidence are runtime-owned and visible in /trace; the status footer shows the active workflow and phase while a workflow is running.

!<command> is not a slash command, but it shares the composer command path. It starts a normal local shell execution turn from the user instead of asking the model to call bash. The same workspace, network, approval, and trace contracts still apply.

  • /model: switch model
  • /utility-model: select the utility model, or unset it from the command palette
  • /reviewer-model: select the reviewer model, or unset it from the command palette
  • /variant: choose provider reasoning effort when supported
  • /thinking: show or hide the reasoning transcript in the TUI
  • /theme: switch theme
  • /connect: connect or configure a provider
  • /trust: manage trust for the current workspace and configured MCP servers

Use this group when you are still shaping the environment the agent runs in rather than asking for repository work directly.

  • /cost: inspect session cost
  • /timeline: branch from a previous completed turn, open related branch sessions, filter/search the branch graph, or inspect a turn with t
  • /trace [turn-number]: inspect one turn
  • /restore [turn-number]: restore writes from one turn in the current session
  • /quit: exit KodaCode

These inspection commands are closely tied to KodaCode’s event-first design:

  • /timeline answers “what if I continued from this earlier point, or opened a related branch?”
  • /trace answers “what actually happened in this turn?”
  • /restore answers “bring back the writes from that turn”

The turn number for /restore is resolved against the currently open session only. If you want to restore writes from an older session, open that session first and then run /restore.

Availability is runtime-aware. For example, /variant is hidden when the current model and tool setup do not support provider reasoning controls.

If you are new, learn these first:

  1. /connect
  2. /model
  3. /timeline
  4. /trace
  5. /cost

Then add /init, /timeline, /compress, /compact, and /restore once you are working on longer-lived repos.