Omnara - Mission Control for Your AI Agents 🚀

⚠️ IMPORTANT NOTICE ⚠️

This version of Omnara is no longer maintained. We apologize for the inconvenience. This version was built as a wrapper around the Claude Code CLI, which became unfeasible to maintain with Claude Code's constant updates.

We've migrated to a new voice-first coding agent platform at https://omnara.com built using the Claude Agent SDK. The new service keeps the features you love - web and mobile access to your machine - but we've built our own integrated experience instead of wrapping the Claude Code CLI. This allows us to provide a more reliable and maintainable service.

• Legacy Web App: The legacy web dashboard for this deprecated version is at https://claude.omnara.com and will continue to work until the end of 2025. To use it, upgrade the Python package to version 1.7.0: pip install omnara==1.7.0
• New Platform: The new version at omnara.com is now a bun executable. Install it with: curl -fsSL https://omnara.com/install/install.sh | bash
• Current Paying Customers: You can contact us at contact@omnara.com for a refund. We will also apply 2 months of free credits to your account on the new platform at omnara.com and you will keep your current payment rate forever
• Mobile App Auto-Updates: If you have auto-updates enabled, your mobile app may have already updated to v1.5.0 (the new platform). If you need access to the older version (< 1.5.0) for this deprecated platform, please reach out to contact@omnara.com and we can provide access via TestFlight
• Building from Source: The web and mobile apps are now fully open source under Apache 2.0. You can build both the web dashboard (apps/web/) and mobile app (apps/mobile/) from source if you prefer to self-host or run an older version
• Questions: For any other questions, please contact us at contact@omnara.com

🚀 Quick Start

# Install Omnara (requires python >= 3.10)
pip install omnara

# Start a Claude Code session that's synced between terminal, web, and mobile
omnara

# Start a Codex CLI session that's synced between terminal, web, and mobile
omnara --agent codex

That's it! Create an account when prompted, then return to your terminal to interact with your coding agent. You can now see and interact with your coding agent session from the web dashboard or the mobile app.

💡 What is Omnara?

Omnara transforms your AI agents (Claude Code, Codex CLI, n8n, and more) from silent workers into communicative teammates. Get real-time visibility into what your agents are doing, and respond to their questions instantly from a single dashboard on web and mobile.

🎬 See It In Action

📖 How to Use

1. Omnara CLI

# Using pip
pip install omnara

# Using uv
uv tool install omnara

# Using pipx
pipx install omnara

omnara

omnara --agent codex

omnara headless

omnara serve

# Using pip
pip install omnara --upgrade

# Using uv
uv tool upgrade omnara

# Using pipx
pipx upgrade omnara

2. n8n Integration

3. GitHub Actions Integration

🔧 Integrating your own Agent into Omnara

Method 1: Manual MCP Configuration

For custom MCP setups, you can configure manually:

{
  "mcpServers": {
    "omnara": {
      "command": "pipx",
      "args": ["run", "--no-cache", "omnara", "mcp", "--api-key", "YOUR_API_KEY"]
    }
  }
}

Method 2: Python SDK

from omnara import OmnaraClient
import uuid

client = OmnaraClient(api_key="your-api-key")
instance_id = str(uuid.uuid4())

# Log progress and check for user feedback
response = client.send_message(
    agent_type="claude-code",
    content="Analyzing codebase structure",
    agent_instance_id=instance_id,
    requires_user_input=False
)

# Ask for user input when needed
answer = client.send_message(
    content="Should I refactor this legacy module?",
    agent_instance_id=instance_id,
    requires_user_input=True
)

Method 3: REST API

curl -X POST https://agent.omnara.com/api/v1/messages/agent \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"content": "Starting deployment process", "agent_type": "claude-code", "requires_user_input": false}'

🏗️ Architecture Overview

Omnara provides a unified platform for monitoring and controlling your AI agents:

graph TB
    subgraph "Your AI Agents"
        A[🤖 AI Agents<br/>Claude Code, Cursor, etc.]
    end

    subgraph "Omnara Platform"
        API[🌐 API Server]
        DB[(📊 PostgreSQL)]
        NOTIFY[🔔 Notification Service<br/>Push/Email/SMS]
    end

    subgraph "Your Devices"
        M[📱 Mobile App]
        W[💻 Web Dashboard]
    end

    A -->|Send updates| API
    API -->|Store data| DB
    API -->|Trigger notifications| NOTIFY
    NOTIFY -->|Alert users| M
    DB -->|Real-time sync| M
    DB -->|Real-time sync| W
    M -->|User responses| API
    W -->|User responses| API
    API -->|Deliver feedback| A

    style A fill:#e3f2fd,stroke:#1976d2,stroke-width:3px,color:#000
    style API fill:#c8e6c9,stroke:#388e3c,stroke-width:2px,color:#000
    style DB fill:#ffccbc,stroke:#d84315,stroke-width:2px,color:#000
    style NOTIFY fill:#fff59d,stroke:#f57f17,stroke-width:2px,color:#000
    style M fill:#f8bbd0,stroke:#c2185b,stroke-width:3px,color:#000
    style W fill:#f8bbd0,stroke:#c2185b,stroke-width:3px,color:#000

For Developers

git clone https://github.com/omnara-ai/omnara
cd omnara
cp .env.example .env
python infrastructure/scripts/generate_jwt_keys.py
./dev-start.sh  # Starts everything automatically

🤝 Contributing

We love contributions! Check out our Contributing Guide to get started.

Development Commands

make lint       # Run code quality checks
make format     # Auto-format code
make test       # Run test suite
./dev-start.sh  # Start development servers

📊 Pricing

🆘 Support

• 💬 GitHub Discussions
• 🐛 Report Issues
• 📧 Email Support
• 📖 Documentation

📜 License

Omnara is open source software licensed under the Apache 2.0 License.