Two Setup Paths
Desktop App
Best starting point on macOS. Installs Omnara and helps you set up your provider.
CLI Setup
Best for Linux, Windows, or anyone who prefers setting things up directly in the terminal.
Desktop App (Recommended for Mac)
The desktop app is the fastest way to get started on macOS.Download Omnara
Download Omnara for macOS (.dmg, Apple Silicon)
Launch and sign in
Open Omnara, sign in, and follow the setup prompts to install and authenticate Claude Code or Codex.
CLI Setup
If you are on Linux or Windows, or you prefer the terminal, use this path.1. Install a Provider
Omnara works with Claude Code or Codex. Install and authenticate one of them first. Claude CodeYou can also use
ANTHROPIC_API_KEY instead of the Claude Code login flow.2. Install Omnara
Install Omnara
Windows users: Run this command in WSL, not PowerShell or Command Prompt.
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
Download the Mac desktop app
iPhone
Use Omnara on iPhone
Apple Watch
Check active sessions from your wrist
Android
Use Omnara on Android
Need Help?
- Authentication if sign-in is confusing or Omnara cannot find Claude Code or Codex
- Remote Sandboxing if you want cloud execution
- Discord: Join our community
- Email:
contact@omnara.com