Skip to main content

​
Prerequisites: Claude Code

Before using Omnara, ensure Claude Code is installed and authenticated. Omnara uses Claude Code for its AI capabilities.
Two authentication methods:
  1. Claude Code CLI (Recommended): 
    claude /login
  2. Environment Variable (Alternative): 
    export ANTHROPIC_API_KEY=sk-ant-...

​
How Authentication Works

When you run omnara for the first time:
  1. Browser opens automatically
  2. Sign in with your preferred method
  3. Return to terminal
  4. Start coding

​
Sign In Options

Email

Email & password

Google

Google account

GitHub

GitHub account

Apple

Apple account

​
Sign Out

omnara auth logout

​
Multi-Device

  • Same account works everywhere
  • Sessions sync in real-time
  • Manage devices from dashboard

​
Security

  • Encrypted token storage (~/.omnara/creds.json)
  • Automatic token refresh
  • TLS for all connections
  • Session isolation

​
Troubleshooting

Install Claude Code:Visit claude.com/product/claude-code to install Claude Code, then authenticate:
claude /login
Or use API key:
export ANTHROPIC_API_KEY=sk-ant-...
omnara
Verify Claude Code login:
claude --version
Re-authenticate if needed:
claude /login
Copy the URL from terminal and open manually
omnara auth logout
omnara
Check internet connection and firewall settings