Skip to content

Interactive session

Run spai with no arguments for a multi-turn interactive session.

CommandWhat it does
/mode manual|auto|planset how tool calls are gated
/model [sel]show providers/models, or switch (/model ollama, /model openai:gpt-4o)
/toolslist available tools
/mcpshow MCP server status and their discovered tools
/costshow estimated token usage and cost for the session
/clearwipe the conversation context
/compactsummarise and compact the session
/historyprint the session history
/sessionslist past sessions
/help, /quithelp (/help <command> for detail), exit

Reference a file with @path to include its contents — press Tab after @ to complete file and directory names.

  • Shift-Tab — cycle the execution mode.
  • Ctrl+C (or Esc) — cancel the current turn.
  • Ctrl+D — exit.

Sessions are file-backed and auto-compact when they grow large. Reopen the most recent one with:

Terminal window
spai resume