> ## Documentation Index
> Fetch the complete documentation index at: https://docs.omnara.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Getting Started

> Get started in under 2 minutes

## Two Setup Paths

<CardGroup cols={2}>
  <Card title="Desktop App" icon="desktop">
    Best starting point for Mac and Windows.
  </Card>

  <Card title="CLI Setup" icon="terminal">
    Best for Linux, Windows WSL, or anyone who prefers setting things up directly in the terminal.
  </Card>
</CardGroup>

## Desktop App (Recommended)

The desktop app is the fastest way to get started with Omnara.

<Steps>
  <Step title="Download Omnara">
    [Mac Apple Silicon](https://releases.omnara.com/desktop/Omnara.dmg) · [Windows x64](https://releases.omnara.com/desktop/OmnaraSetup-x64.exe) · [Windows ARM64](https://releases.omnara.com/desktop/OmnaraSetup-arm64.exe)
  </Step>

  <Step title="Install">
    Open the downloaded file and install Omnara.
  </Step>

  <Step title="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.
  </Step>

  <Step title="Start coding">
    Open a project and start chatting with your coding agent.
  </Step>
</Steps>

## CLI Setup

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

### 1. Install Omnara

<Steps>
  <Step title="Install Omnara">
    <Note>
      **Windows users**: Run this command in [WSL](https://learn.microsoft.com/en-us/windows/wsl/install), not PowerShell or Command Prompt.
    </Note>

    ```bash theme={null}
    curl -fsSL https://omnara.com/install.sh | bash
    ```
  </Step>

  <Step title="Open your project">
    ```bash theme={null}
    cd /path/to/your/project
    ```
  </Step>

  <Step title="Start Omnara">
    ```bash theme={null}
    omnara
    ```
  </Step>

  <Step title="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.
  </Step>
</Steps>

### 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**

```bash theme={null}
omnara-claude /login
```

<Note>
  You can also use `ANTHROPIC_API_KEY` instead of the Claude Code login flow.
</Note>

**Codex**

```bash theme={null}
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

<CardGroup cols={2}>
  <Card title="Web" icon="browser" href="https://omnara.com">
    Open the dashboard in your browser
  </Card>

  <Card title="Desktop App" icon="desktop">
    [Mac Apple Silicon](https://releases.omnara.com/desktop/Omnara.dmg) · [Windows x64](https://releases.omnara.com/desktop/OmnaraSetup-x64.exe) · [Windows ARM64](https://releases.omnara.com/desktop/OmnaraSetup-arm64.exe)
  </Card>

  <Card title="iPhone" icon="apple" href="https://apps.apple.com/us/app/omnara-ai-command-center/id6748426727">
    Use Omnara on iPhone
  </Card>

  <Card title="Apple Watch" icon="watch" href="/apple-watch">
    Check active sessions from your wrist
  </Card>

  <Card title="Android" icon="android" href="https://play.google.com/store/apps/details?id=com.omnara.app">
    Use Omnara on Android
  </Card>
</CardGroup>

## Need Help?

* [Authentication](/authentication) if sign-in is confusing or Omnara cannot find Claude Code or Codex
* [Remote Sandboxing](/remote-sandboxing) if you want cloud execution
* Discord: [Join our community](https://discord.gg/Dc46sYk6e3)
* Email: `contact@omnara.com`