Getting Started

What is OMAR?

OMAR is a TUI for creating powerful agentic organizations. It runs on tmux and lets you orchestrate deep hierarchies of parallel AI agents from a single terminal.

Prerequisites

Installation

One-Liner (Recommended)

$ curl -fsSL https://omar.tech/install.sh | sh

Works on macOS and Linux. Installs all binaries to /usr/local/bin.

Homebrew

$ brew install lsk567/omar/omar

Automatically installs tmux as a dependency.

From Source

$ git clone https://github.com/lsk567/omar.git
$ cd omar && make install

Requires Rust 1.70+ and GNU Make.

Launch

$ omar

This starts the OMAR dashboard with the default agent backend (Claude Code). To use a different backend:

BackendCommand
Claude Codeomar or omar --agent claude
Codex CLIomar --agent codex
Opencodeomar --agent opencode
Cursor CLIomar --agent cursor
Gemini CLIomar --agent gemini

Your First Session

  1. Launch omar — you'll see the TUI dashboard with your Executive Assistant (EA)
  2. Copy a test prompt into your EA window: 
    Load and run https://github.com/lsk567/omar/blob/main/prompts/tests/project-factory.md
  3. Watch agents spawn. Use ↑↓ to navigate, Tab to drill into an agent, Shift+Tab to back out
  4. To shut down: 
    Shutdown the test project and its agents.

Key Bindings

KeyAction
←/→ or h/lSwitch panel (sidebar / main)
↑/↓ or j/kMove selection up/down
TabDrill into selected agent
Shift+Tab or EscBack (drill up)
EnterAttach to selected agent
nSpawn new agent
dKill selected agent
NSpawn new EA (prompts for name)
DDelete current EA
[Previous EA
]Next EA
pAdd a project
eShow scheduled events
SSettings
GDebug console
rRefresh agent list
zDetach (dashboard keeps running)
?Toggle help
QQuit

Next Steps