Session Commands Reference

All commands available within an interactive Octomind session. Type the command at the prompt.

Session Management

/help

Show all available commands with descriptions.

/exit / /quit

Exit the current session.

/list [PAGE]

List all saved sessions. Optional page number for pagination.

/session [NAME]

Switch to a different session by name. Without argument, shows current session info.

/save

Manually save the current session. Sessions are also auto-saved.

/clear

Clear the terminal screen.

Information & Monitoring

/info

Display comprehensive session statistics:

  • Token usage (input, output, cached, reasoning)
  • Cost breakdown (per-request and cumulative)
  • Cache savings (tokens and USD)
  • Compression statistics (if compression has occurred)
  • Model information

/report

Generate a detailed usage report for the session with per-request breakdown.

/model [MODEL]

Show or change the current model. Without argument, displays current model. With argument, switches to specified model in provider:model format.

/model openai:gpt-4o
/model anthropic:claude-sonnet-4

/role [ROLE]

Show or change the current role. Without argument, displays current role.

/role assistant
/role developer

/loglevel [LEVEL]

Change the log level. Options: none, info, debug.

/loglevel debug

Context Management

/context [FILTER]

View session context (message history). Filters:

  • all -- Show all messages
  • assistant -- Only assistant messages
  • user -- Only user messages
  • tool -- Only tool calls and results
  • large -- Only messages exceeding a token threshold
/context
/context tool
/context large

/summarize

Compress conversation history using AI summarization. Reduces token usage while preserving key context.

/truncate

Trim context by removing oldest messages. More aggressive than /summarize.

/done

Mark the current task as complete. Triggers:

  • Plan completion (if a plan is active)
  • Session cleanup and summary
  • Optional memorization of key findings

Media

/image <PATH>

Attach an image for AI analysis. Supports PNG, JPEG, GIF, WebP.

/image screenshot.png
/image /path/to/diagram.jpg

/video <PATH>

Attach a video for AI analysis.

/video demo.mp4

/copy

Copy the last assistant response to the clipboard.

MCP & Tools

/mcp [ACTION] [ARGS]

Manage MCP servers at runtime.

Action Description
/mcp or /mcp list List all MCP servers with status
/mcp info Detailed server information
/mcp health Force health check on all servers
/mcp validate Validate MCP configuration
/mcp add <name> <url> Add HTTP server dynamically
/mcp enable <name> Enable a registered server
/mcp disable <name> Disable a server
/mcp remove <name> Remove a server

Commands & Workflows

/run [COMMAND]

Execute a custom command defined in [[commands]] config section. Without argument, lists available commands.

/run reduce
/run estimate

/workflow [NAME]

Execute a workflow. Without argument, lists available workflows.

/workflow developer_workflow

/prompt [NAME]

Inject a prompt template defined in [[prompts]] config section. Without argument, lists available prompts.

/prompt review
/prompt explain

/plan [ACTION]

Manage the structured task plan.

Action Description
/plan or /plan show Show current plan with progress
/plan clear Reset/abort the current plan