Tutorial

Overlay Tutorial

The primary tutorial is a game-style overlay that renders on top of the TUI and guides you through features step by step. Launch it with: 

/tutorial

The overlay highlights relevant UI elements, explains what they do, and prompts you to try each feature. Steps include:

  1. Welcome — choose "Start Fresh" (new project) or "My Project" (existing project auto-advances)
  2. Editor — type prompts in the wrapped multiline editor, use Shift+Enter for newline insertion, and rely on the visible cursor for exact position
  3. Tool Cards — how agent tool calls render, expand with Ctrl+O
  4. Model Selection — /model to switch providers and models
  5. Thinking Levels — /think to control reasoning depth
  6. Project Memory — how facts persist, /memory for stats
  7. Web Dashboard — /dash opens the live browser dashboard
  8. Sessions — auto-save, resume orientation, and session-log-backed narrative continuity

First-Run Behavior

On first launch, Omegon starts with the tutorial overlay active (unless --no-splash is passed). You can also launch it explicitly at any time. 

# Start Omegon in tutorial mode
omegon --tutorial

# Launch tutorial from within a session
/tutorial

# Check tutorial progress
/tutorial status

# Reset tutorial state
/tutorial reset

Legacy Lessons

The older lesson-based tutorial (sequential text lessons with /next and /prev navigation) is still available: 

/tutorial lessons

The overlay tutorial is the recommended path for new users. Legacy lessons are preserved for users who prefer a text-only walkthrough.