Getting Started

What is OMAR?

OMAR (one-man army) is a TUI dashboard for creating and managing powerful agentic organizations. It runs on tmux and lets you orchestrate deep hierarchies of parallel AI coding agents from a single terminal.

Prerequisites

tmux 3.0+ — session multiplexer
Rust 1.70+ — for building from source
GNU Make — build system
An agent backend — Claude Code (default) or Opencode

Installation

$ make install

Launch

$ omar

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

$ omar --agent opencode

Your First Session

Launch omar — you'll see the TUI dashboard with your executive assistant (EA)

Copy a prompt into your EA window:

Load and run <omar-root>/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
`↑/↓`	Navigate agents at current level
`→`	Drill into deeper level
`←`	Back out to parent level
`Enter`	Attach to agent (popup)
`n`	Spawn new agent
`r`	Refresh status
`q`	Quit dashboard

Next Steps

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