Skip to main content
1

Install Omnara

Choose your preferred package manager:
pip install omnara
2

Start Your Agent

Launch Claude Code with dashboard integration:
omnara
On first run, this will:
  1. Open your browser for authentication
  2. Prompt you to sign in to Omnara (or create an account)
  3. Automatically save your API key to ~/.omnara/credentials.json
Everything you do in the terminal is now synced to your dashboard and mobile app.
Authentication happens automatically on first run. You can also explicitly authenticate with omnara --auth if needed.
3

Try Other Modes

Explore different usage patterns:
# Run in background without terminal UI
omnara headless --prompt "Review this codebase"

​
Next Steps

CLI Commands

Explore all available commands

n8n Integration

Add human-in-the-loop to workflows

Python SDK

Build custom integrations

Environment Variables

Configure with env vars

​
Common Workflows

# Set Claude as default
omnara --set-default claude

# Start a named session
omnara --name "Feature Development"

# Work in terminal as usual
# Everything syncs to dashboard automatically

# Start headless review
omnara headless \
  --prompt "Review all files in src/ for security issues" \
  --allowed-tools Read,Grep \
  --cwd /path/to/project

# Check dashboard for results
# Respond to any questions Claude asks

# On your computer, start webhook server
omnara serve

# From your phone:
# 1. Open Omnara app
# 2. Go to Settings → Integrations
# 3. Add webhook configuration
# 4. Tap "Launch Agent" to trigger Claude on your computer

​
Troubleshooting

# Try re-authenticating
omnara --reauth

# Or set API key manually
export OMNARA_API_KEY="your-key-here"
omnara
Ensure the agent CLI is installed:
# Claude Code
claude --version

# Codex (packaged with Omnara)
# Should work out of the box

# Amp
amp --version
  1. Check you’re not using --no-relay
  2. Verify internet connection
  3. Check logs: ~/.omnara/<agent>_wrapper/<session-id>.log