Quick Start

If you only want the shortest path to a working setup, skip this page and start with Get Working Fast. This quick start is broader — it assumes you want both a first success and a light tour of the interface.

1. Install & Authenticate

curl -fsSL https://omegon.styrene.dev/install.sh | sh
export ANTHROPIC_API_KEY="sk-ant-..."   # or: omegon login
omegon

You'll see the splash screen, then the TUI opens with an editor at the bottom, the conversation view in the center, and the instrument panel on the right.

2. Your First Prompt

Type a prompt and press Enter:

Read README.md and summarize the project structure

The agent will call the read tool, display the file contents in a collapsible tool card, and respond with a summary. Each tool card shows the tool name and a one-line summary of its arguments.

3. Explore the Interface

ElementWhat It Shows
Left gutter (│)Teal bar marks assistant responses
Tool cardsCollapsible cards for each tool call. Press Ctrl+O to pin one open.
Meta tagDim header on each response: model · provider · tier · think:level
Right panelInstrument panel with context, memory, and tool telemetry
FooterModel, context %, tool call count, session duration

4. Key Commands

/model         # Switch model (opens selector)
/think high    # Enable extended reasoning
/compact       # Free context window space
/stats         # View session telemetry
/status        # Check provider and system status
/tutorial      # Launch the interactive tutorial overlay

5. Project Memory

Omegon automatically persists important facts across sessions. First time in a project: 

/init          # Scan project, set up memory, orient the agent

The agent will discover your project structure, record architectural facts, and offer to help. Memory survives across sessions — the agent remembers what it learned.

6. Multi-File Changes

For complex changes that touch multiple files, the agent can decompose work and execute in parallel: 

# The agent will assess complexity and suggest /cleave if warranted:
"Refactor the auth module to support OAuth2 PKCE flow"

# Or decompose explicitly:
/cleave

Cleave creates isolated git worktree branches for each subtask, executes them in parallel, detects conflicts, and merges results back to your working branch.

7. Sessions

Sessions auto-save on exit. Resume where you left off: 

# Resume most recent session
omegon --resume

# List saved sessions
/sessions

# Resume a specific session
omegon --resume abc123

8. Web Dashboard

/dash          # Opens browser to the live web dashboard

The web dashboard connects over WebSocket and shows real-time conversation, tool calls, memory state, and design tree status. Useful for remote monitoring or sharing your screen.

Next Steps