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
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
omnara daemon stop
omnara kill all-force
rm -rf ~/.omnara
Platform Cleanup
macOSlaunchctl unload ~/Library/LaunchAgents/com.omnara.daemon.plist
rm -f ~/Library/LaunchAgents/com.omnara.daemon.plist
systemctl --user disable com.omnara.daemon
rm -f ~/.config/systemd/user/com.omnara.daemon.service
systemctl --user daemon-reload
schtasks /Delete /TN "OmnaraDaemon" /F
Optional: remove the
# omnara PATH block from your shell config if you want to clean up PATH changes.