# Install Omnara
pip install omnara

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

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

Omnara transforms your AI agents (Claude Code, Cursor, GitHub Copilot, and more) from silent workers into communicative teammates. Get real-time visibility into what your agents are doing, respond to their questions instantly, and guide them to success - all from your phone.

The moment your agent needs help, you're there. No more returning to failed jobs hours later.

We built Omnara because we were tired of:

• ❌ Starting long agent jobs and finding them stuck hours later
• ❌ Missing critical questions that blocked progress
• ❌ Having no visibility into what our AI was actually doing
• ❌ Being tied to our desks while agents worked

Now you can:

• ✅ Launch agents and monitor them from anywhere
• ✅ Get push notifications when input is needed
• ✅ Send real-time feedback to guide your agents
• ✅ Have confidence your AI workforce is productive

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

1. Connect Your Agent → Install Omnara SDK or wrapper
2. Get Real-Time Updates → See every step your agent takes
3. Respond Instantly → Answer questions from anywhere

• Backend: FastAPI with separate read/write servers for optimal performance
• Frontend: React (Web) + React Native (Mobile)
• Protocol: Model Context Protocol (MCP) + REST API
• Database: PostgreSQL with SQLAlchemy ORM
• Auth: Dual JWT system (Supabase for users, custom for agents)

See what Claude is doing in real-time:

1. Install Omnara:

   # Using pip
   pip install omnara
   
   # Using uv (faster)
   uv tool install omnara

2. Start monitoring:

   # If installed with pip or uv
   omnara
   
   # Using pipx (no omnara installation required)
   pipx run omnara
   
   # Using uvx (no omnara installation required)
   uvx omnara

3. Authenticate in your browser (opens automatically)
4. See everything your agent does in the Omnara dashboard!

Trigger Claude from your phone:

1. Start the server on your computer:

   # Using pip
   pip install omnara
   omnara serve
   
   # Using uv (faster)
   uv tool install omnara
   omnara serve

2. Set up your agent in the mobile app with the webhook URL shown
3. Launch agents from anywhere - beach, coffee shop, bed!

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

Note: Most users should use the simple omnara or omnara serve commands shown above. These methods are for advanced users who need custom integrations or want to run the underlying scripts directly.

Run the monitoring wrapper directly (what omnara does under the hood):

# Basic usage
python -m integrations.cli_wrappers.claude_code.claude_wrapper_v3 --api-key YOUR_API_KEY

# With git diff tracking
python -m integrations.cli_wrappers.claude_code.claude_wrapper_v3 --api-key YOUR_API_KEY --git-diff

# Custom API endpoint (for self-hosted)
python -m integrations.cli_wrappers.claude_code.claude_wrapper_v3 --api-key YOUR_API_KEY --base-url https://your-server.com

For custom MCP setups, you can configure manually:

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

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
)

curl -X POST https://api.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}'

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

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

• 💬 GitHub Discussions
• 🐛 Report Issues
• 📧 Email Support
• 📖 Documentation (coming soon)

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