Getting Started

OMAR is a deterministic orchestration runtime for agentic systems. You describe what a team should do; OMAR compiles that into a program with an explicit topology, then runs it — in your browser, or from a terminal.

Prerequisites

• tmux 3.0+ — brew install tmux on macOS or apt install tmux on Debian/Ubuntu.
• At least one supported coding agent: Claude Code, Codex CLI, Cursor CLI, Opencode, or Google Antigravity CLI.

Install

One-liner (recommended)

curl -fsSL https://omar.rs/install.sh | sh

The installer supports macOS and Linux and installs OMAR binaries to /usr/local/bin by default.

Homebrew

brew install omar-os/omar/omar

The OMAR tap installs tmux as a dependency.

Build from source

git clone https://github.com/omar-os/omar.git
cd omar
make install

Building from source requires Rust 1.70+ and GNU Make.

Launch Mission Control

omar serve --ui

Serves the web UI from the daemon's own address and opens it in your browser. The page and the API share an origin, so there is nothing to point at anything.

Describe a workflow. The assistant drafts an OMAR program and shows you the topology it compiles to; nothing runs until you confirm. Then the diagram goes live — ports carry values, reactions light up as their agents work, and double-clicking an agent opens its terminal.

Launch the terminal UI

omar

The same runtime, driven from tmux instead. OMAR detects installed backends automatically; select one explicitly with -a:

Run your first workflow in the terminal

1. Launch omar to open the dashboard and Executive Assistant.
2. Paste this task into the Executive Assistant window:

   Run https://github.com/omar-os/omar/blob/main/prompts/tests/project-factory.md

3. Watch the team form. Use the arrow keys to move between agents, Tab to drill down, and Shift+Tab to move back up.
4. When you are finished, tell the Executive Assistant:

   Shutdown the test project and its agents.

Browse the source, releases, and issue tracker on GitHub.