https://github.com/omnara-ai/omnara

Omnara (YC S25) - Talk to Your AI Agents from Anywhere!
https://github.com/omnara-ai/omnara

Last synced: about 1 month ago
JSON representation

Omnara (YC S25) - Talk to Your AI Agents from Anywhere!

Host: GitHub
URL: https://github.com/omnara-ai/omnara
Owner: omnara-ai
License: apache-2.0
Created: 2025-07-09T01:30:55.000Z (3 months ago)
Default Branch: main
Last Pushed: 2025-09-03T08:38:46.000Z (about 1 month ago)
Last Synced: 2025-09-03T09:02:55.790Z (about 1 month ago)
Language: Python
Homepage: https://omnara.com
Size: 45.4 MB
Stars: 2,135
Watchers: 8
Forks: 136
Open Issues: 28
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE

Awesome Lists containing this project

awesome-AI-driven-development - Omnara - Get real-time visibility into what your agents are doing, and respond to their questions instantly from a single dashboard on web and mobile. (Multi-Agent & Orchestration / Other IDEs)

README

          # Omnara - Mission Control for Your AI Agents 🚀



**Your AI workforce, in your pocket.**

[![PyPI version](https://badge.fury.io/py/omnara.svg)](https://badge.fury.io/py/omnara)

[![Downloads](https://pepy.tech/badge/omnara)](https://pepy.tech/project/omnara)

[![Python Versions](https://img.shields.io/pypi/pyversions/omnara.svg)](https://pypi.org/project/omnara/)

[![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)

[![GitHub stars](https://img.shields.io/github/stars/omnara-ai/omnara?style=social)](https://github.com/omnara-ai/omnara)

[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)



![Omnara Mobile Experience](./docs/assets/three-panel.png)



[📱 **Download iOS App**](https://apps.apple.com/us/app/omnara-ai-command-center/id6748426727) • [🌐 **Try Web Dashboard**](https://omnara.com) • [🎥 **See a Demo**](https://www.loom.com/share/03d30efcf8e44035af03cbfebf840c73?sid=1c209c04-8a4c-4dd6-8c92-735c399886a6) • [⭐ **Star on GitHub**](https://github.com/omnara-ai/omnara)



---

## 🚀 Quick Start

```bash

# 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](https://omnara.com/dashboard) or the [mobile app](https://apps.apple.com/us/app/omnara-ai-command-center/id6748426727).

## 💡 What is Omnara?

Omnara transforms your AI agents (Claude Code, 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

![Agent Activity Feed](./docs/assets/Mobile-app-showcase.gif)

## 📖 How to Use

### 1. Omnara CLI

The primary way to use Claude Code with Omnara

#### Installation

Install Omnara using your preferred package manager:

```bash

# Using pip

pip install omnara

# Using uv

uv tool install omnara

# Using pipx

pipx install omnara

```

#### Running Omnara

Omnara offers three different modes depending on your workflow:

##### **Standard Mode** - Full Claude Code Experience

```bash

omnara

```

Starts Claude Code with the standard CLI interface, fully synced across terminal, web dashboard, and mobile app. You interact with Claude Code in your terminal as usual, while everything is mirrored to the Omnara dashboard.

##### **Headless Mode** - Dashboard-Only Interaction

```bash

omnara headless

```

Runs Claude Code in the background without the terminal UI. Perfect for when you want to interact with Claude Code exclusively through the Omnara web dashboard or mobile app.

##### **Server Mode** - Remote Launch Capability

```bash

omnara serve

```

Exposes an endpoint that allows you to launch Claude Code instances remotely from the Omnara dashboard. Ideal for triggering AI agents from your phone or another device.

#### Upgrading

Keep Omnara up-to-date with the latest features:

```bash

# Using pip

pip install omnara --upgrade

# Using uv

uv tool upgrade omnara

# Using pipx

pipx upgrade omnara

```

### 2. n8n Integration

Add human-in-the-loop capabilities to your n8n workflows

#### What it Does

The Omnara n8n integration provides a specialized "Human in the Loop" node that enables real-time human-AI collaboration within your n8n workflows. Perfect for approval workflows, agent conversations, and guided automation.

#### Installation & Setup

For detailed installation and configuration instructions, see the [n8n-nodes-omnara package](https://www.npmjs.com/package/n8n-nodes-omnara) on npm.

### 3. GitHub Actions Integration

Run Claude Code in GitHub Actions with Omnara monitoring

#### What it Does

The Omnara GitHub Actions integration allows you to trigger Claude Code to run in your GitHub Actions workflows via repository dispatch events, while monitoring and interacting with it through the Omnara dashboard.

#### Key Features

- **Remote Launch**: Start GitHub Actions from your phone or web dashboard

- **Automatic PR Creation**: Claude creates branches, commits changes, and opens PRs

- **Real-time Monitoring**: Track progress and provide guidance through Omnara

#### Installation & Setup

For complete setup instructions including GitHub workflow configuration, see the [GitHub Actions integration guide](./integrations/github/claude-code-action/README.md).

## 🔧 Integrating your own Agent into Omnara

### Method 1: Manual MCP Configuration

For custom MCP setups, you can configure manually:

```json

{

  "mcpServers": {

    "omnara": {

      "command": "pipx",

      "args": ["run", "--no-cache", "omnara", "mcp", "--api-key", "YOUR_API_KEY"]

    }

  }

}

```

### Method 2: Python SDK

```python

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

```bash

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}'

```

## 🏗️ Architecture Overview

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

```mermaid

graph TB

    subgraph "Your AI Agents"

        A[🤖 AI Agents
Claude Code, Cursor, etc.]

    end

    subgraph "Omnara Platform"

        API[🌐 API Server]

        DB[(📊 PostgreSQL)]

        NOTIFY[🔔 Notification Service
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

🛠️ Development Setup

**Prerequisites:** Docker, Python 3.10+, Node.js

**Quick Start:**

```bash

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

```

**Stop services:** `./dev-stop.sh`

For detailed setup instructions, manual configuration, and contribution guidelines, see our [Contributing Guide](CONTRIBUTING.md).

## 🤝 Contributing

We love contributions! Check out our [Contributing Guide](CONTRIBUTING.md) to get started.

### Development Commands

```bash

make lint       # Run code quality checks

make format     # Auto-format code

make test       # Run test suite

./dev-start.sh  # Start development servers

```

## 📊 Pricing

| Plan | Price | Features |

|------|-------|----------|

| **Free** | $0/mo | 10 agents/month, Core features |

| **Pro** | $9/mo | Unlimited agents, Priority support |

| **Enterprise** | [Contact Us](https://cal.com/ishaan-sehgal-8kc22w/omnara-demo) | Teams, SSO, Custom integrations |

## 🆘 Support

- 💬 [GitHub Discussions](https://github.com/omnara-ai/omnara/discussions)

- 🐛 [Report Issues](https://github.com/omnara-ai/omnara/issues)

- 📧 [Email Support](mailto:ishaan@omnara.com)

- 📖 Documentation (coming soon)

## 📜 License

Omnara is open source software licensed under the [Apache 2.0 License](LICENSE).

---



**Built with ❤️ by the Omnara team**

[Website](https://omnara.com) • [Twitter](https://twitter.com/omnaraai) • [LinkedIn](https://linkedin.com/company/omnara)

ecosyste.ms

Data

Tools

Indexes

Applications

Experiments

Awesome

https://github.com/omnara-ai/omnara

Awesome Lists containing this project

README