Home

omp GUI Wiki

Welcome to the omp GUI wiki — the desktop control center for the omp coding agent.

What is omp GUI?

omp GUI is a native macOS desktop app that wraps the omp coding agent in a fast Electron shell. It bundles the agent as a built-in binary — no need to separately install omp, Bun, or Node — and provides a full visual interface for running parallel agent sessions, inspecting tool calls, and managing models, providers, and usage.

The TUI and GUI coexist and share the same ~/.omp config and sessions.

Quick Links

• Getting Started — Install, sign in, run your first session
• Features — Full feature catalog with screenshots
• Architecture — How the app works under the hood
• Keyboard Shortcuts — Complete reference
• Development — Build from source, dev commands, testing
• Troubleshooting — Common issues and fixes

Key Features at a Glance

• Parallel sessions — up to 10 tabs, each with its own sidecar and optional git worktree
• Command palette — every / command as a searchable menu (⌘K)
• Visual tool calls — bash, edit, read, grep, task rendered live with real diffs
• Conversation dock — todos, plan review, subagents, and queued work stay live between the transcript and composer
• Model & provider management — OAuth login, model comparison, usage dashboard
• Bundled agent — zero external dependencies, ships its own omp binary

Install

Download v0.7.3:

• Apple Silicon: omp-0.7.3-arm64.dmg
• Intel: omp-0.7.3.dmg

Open the .dmg, drag omp to Applications, then right-click → Open (the build is unsigned).

See Getting Started for the full walkthrough.