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

# CLI Reference

> Omnara command line interface

## Commands

| Command                | Description                              |
| ---------------------- | ---------------------------------------- |
| `omnara`               | Start agent session in current directory |
| `omnara -b <branch>`   | Start session on specific git branch     |
| `omnara --claude-code` | Only check Claude Code at startup        |
| `omnara --codex`       | Only check Codex at startup              |

### Authentication

| Command              | Description                       |
| -------------------- | --------------------------------- |
| `omnara auth login`  | Authenticate via browser          |
| `omnara auth logout` | Clear stored credentials          |
| `omnara auth status` | Show current authentication state |

### Daemon

The daemon runs in the background to manage sessions.

| Command                         | Description                                |
| ------------------------------- | ------------------------------------------ |
| `omnara daemon start`           | Start background daemon                    |
| `omnara daemon start --no-wait` | Start daemon without waiting for readiness |
| `omnara daemon stop`            | Stop daemon                                |
| `omnara daemon status`          | Show daemon status                         |

### Process Management

| Command                 | Description                     |
| ----------------------- | ------------------------------- |
| `omnara kill daemon`    | Kill daemon process             |
| `omnara kill sessions`  | Kill all session processes      |
| `omnara kill all`       | Kill daemon and all sessions    |
| `omnara kill all-force` | Force kill all Omnara processes |

### Workspace

| Command                                         | Description                           |
| ----------------------------------------------- | ------------------------------------- |
| `omnara workspace sync`                         | Enable sync and upload checkpoints    |
| `omnara workspace sync --force`                 | Force re-upload checkpoints           |
| `omnara workspace sync --directory <path>`      | Target a specific workspace directory |
| `omnara workspace sync disable`                 | Disable sync for this workspace       |
| `omnara workspace config`                       | View or update workspace settings     |
| `omnara workspace config --base-ref <ref>`      | Set base branch for diffs             |
| `omnara workspace config --remote <name>`       | Set git remote name                   |
| `omnara workspace config --directory <path>`    | Target a specific workspace directory |
| `omnara workspace load -w <id> -c <checkpoint>` | Restore a workspace from a checkpoint |
| `omnara workspace load --directory <path>`      | Target directory for restore          |

## Global Options

```bash theme={null}
omnara --help      # Show help
omnara --version   # Show version
```

## Environment Variables

| Variable                         | Description                                                    |
| -------------------------------- | -------------------------------------------------------------- |
| `ANTHROPIC_API_KEY`              | Alternative to `omnara-claude /login`                          |
| `OMNARA_BACKEND_URL`             | Custom backend URL (advanced)                                  |
| `OMNARA_FRONTEND_URL`            | Custom frontend URL (advanced)                                 |
| `OMNARA_DEBUG_STARTUP`           | Set to `1` for verbose startup logging                         |
| `OMNARA_NO_UPDATE`               | Set to `1` to skip auto-updates                                |
| `OMNARA_NO_SERVICE`              | Set to `1` to disable background service                       |
| `OMNARA_STARTUP_CHECK_PROVIDERS` | Comma-separated providers to check (e.g., `claude_code,codex`) |

## Uninstall

```bash theme={null}
omnara daemon stop
omnara kill all-force
rm -rf ~/.omnara
```

### Platform Cleanup

**macOS**

```bash theme={null}
launchctl unload ~/Library/LaunchAgents/com.omnara.daemon.plist
rm -f ~/Library/LaunchAgents/com.omnara.daemon.plist
```

**Linux**

```bash theme={null}
systemctl --user disable com.omnara.daemon
rm -f ~/.config/systemd/user/com.omnara.daemon.service
systemctl --user daemon-reload
```

**Windows**

```bash theme={null}
schtasks /Delete /TN "OmnaraDaemon" /F
```

<Note>
  Optional: remove the `# omnara` PATH block from your shell config if you want to clean up PATH changes.
</Note>