Commands
| Command | Description |
|---|---|
omnara | Start agent session in current directory |
omnara -b <branch> | Start session on specific git branch |
Authentication
| Command | Description |
|---|---|
omnara auth login | Authenticate via browser |
omnara auth logout | Clear stored credentials |
omnara auth status | Show authentication state |
Daemon
The daemon runs in the background to manage sessions.| Command | Description |
|---|---|
omnara daemon start | Start background daemon |
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 |
Workspace
| Command | Description |
|---|---|
omnara workspace sync | Enable sync and upload checkpoints |
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 |
Global Options
Environment Variables
| Variable | Description |
|---|---|
ANTHROPIC_API_KEY | Alternative to 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 |