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

tmux 3.0+ — brew install tmux (macOS) or apt install tmux (Debian/Ubuntu)
At least one agent backend: Claude Code, Codex CLI, Opencode, or Cursor CLI

Installation

One-Liner (Recommended)

$ curl -fsSL https://omarmy.ai/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:

Backend	Command
Claude Code	`omar` or `omar --agent claude`
Codex CLI	`omar --agent codex`
Opencode	`omar --agent opencode`
Cursor CLI	`omar --agent cursor`

Your First Session

Launch omar — you'll see the TUI dashboard with your Executive Assistant (EA)

Copy a test prompt into your EA window:

Load and run https://github.com/lsk567/omar/blob/main/prompts/tests/project-factory.md

Watch agents spawn. Use ↑↓ to cycle agents, → to drill deeper, ← to go back

To shut down:

Shutdown the test project and its agents.

Key Bindings

Key	Action
`↑/↓` or `j/k`	Navigate agents
`→` or `Tab`	Drill into child agents
`←`	Back to parent level
`Enter`	Attach to agent (tmux popup)
`n`	Spawn new agent
`d`	Delete agent (with confirmation)
`p`	Add project
`e`	Show events
`r`	Refresh status
`z`	Detach from tmux
`D`	Debug console
`?`	Help
`Q`	Quit (with confirmation)

Next Steps

Architecture & Design — understand how OMAR works
HTTP API Reference — programmatic agent control
Agent Orchestration — manager-worker patterns