Skip to content

Composer 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 durable 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
/sessionsManage workspace sessionsResume, switch, inspect, delete, or purge existing sessions
/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
!<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
/trace [turn-number]Inspect one turnOpen without an argument to choose interactively when supported
/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
  • /sessions: manage workspace sessions, including delete and purge actions
  • /init: create workspace instruction files
  • /compress: compress AGENTS.md and project memory
  • /compact: rebuild older session history into the durable History Summary artifact now
  • /new: start a new session
  • /history: search recent prompts through the searchable history popup
  • /review [instructions]: run a focused runtime-owned review of the current workspace changes

Use this group when you want to move between sessions, inspect prior work, or prepare the current session before another turn.

/compact only affects durable 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 contract authoritative.

!<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
  • /trace [turn-number]: inspect one turn
  • /restore [turn-number]: restore writes from one turn in the current session
  • /quit: exit KodaCode

/trace and /restore are the two commands most closely tied to KodaCode’s event-first design:

  • /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. /sessions
  4. /trace
  5. /cost

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