Skip to main content

​
Two Setup Paths

Desktop App

Best starting point for Mac and Windows.

CLI Setup

Best for Linux, Windows WSL, or anyone who prefers setting things up directly in the terminal.
The desktop app is the fastest way to get started with Omnara.
1

Download Omnara

Mac Apple Silicon · Windows x64 · Windows ARM64
2

Install

Open the downloaded file and install Omnara.
3

Launch and sign in

Open Omnara and sign in. If Claude Code or Codex is already authenticated on this machine, you can start coding immediately.
4

Start coding

Open a project and start chatting with your coding agent.

​
CLI Setup

If you are on Linux, Windows WSL, or you prefer the terminal, use this path.

​
1. Install Omnara

1

Install Omnara

Windows users: Run this command in WSL, not PowerShell or Command Prompt.
curl -fsSL https://omnara.com/install.sh | bash
2

Open your project

cd /path/to/your/project
3

Start Omnara

omnara
4

Follow the prompts

Omnara checks Claude Code and Codex first. If either provider is already signed in, your browser opens so you can sign in to Omnara.

​
2. If Provider Setup Is Needed

Omnara bundles Claude Code and Codex. If your selected provider is already signed in on this machine, there is nothing else to do. If startup checks say setup is needed, authenticate one bundled provider, then run omnara again: Claude Code 
omnara-claude /login
You can also use ANTHROPIC_API_KEY instead of the Claude Code login flow.
Codex 
omnara-codex login

​
What Happens Next

After setup, Omnara starts a synced coding session in your project. This means sessions can keep running locally on your machine while you monitor it, reply to it, and steer it remotely from mobile, web, or any of your other devices.

​
Optional Setup

You do not need these on day one, but they unlock more features:
  • Connect GitHub if you want sandbox workflows for GitHub repos or pull request features
  • Enable workspace sync if you want remote sandbox migration based on checkpoints

​
Access Anywhere

Web

Open the dashboard in your browser

Desktop App

Mac Apple Silicon · Windows x64 · Windows ARM64

iPhone

Use Omnara on iPhone

Apple Watch

Check active sessions from your wrist

Android

Use Omnara on Android

​
Need Help?