{"id":30231991,"url":"https://github.com/omnara-ai/omnara","last_synced_at":"2025-09-03T09:04:41.556Z","repository":{"id":303705889,"uuid":"1016411413","full_name":"omnara-ai/omnara","owner":"omnara-ai","description":"Omnara (YC S25) - Talk to Your AI Agents from Anywhere!","archived":false,"fork":false,"pushed_at":"2025-09-03T08:38:46.000Z","size":47620,"stargazers_count":2135,"open_issues_count":28,"forks_count":136,"subscribers_count":8,"default_branch":"main","last_synced_at":"2025-09-03T09:02:55.790Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://omnara.com","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/omnara-ai.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-07-09T01:30:55.000Z","updated_at":"2025-09-03T08:38:34.000Z","dependencies_parsed_at":"2025-07-09T02:31:12.847Z","dependency_job_id":"52d491c3-0140-4f6f-a485-7c7c616d60ec","html_url":"https://github.com/omnara-ai/omnara","commit_stats":null,"previous_names":["omnara-ai/omnara"],"tags_count":55,"template":false,"template_full_name":null,"purl":"pkg:github/omnara-ai/omnara","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/omnara-ai%2Fomnara","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/omnara-ai%2Fomnara/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/omnara-ai%2Fomnara/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/omnara-ai%2Fomnara/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/omnara-ai","download_url":"https://codeload.github.com/omnara-ai/omnara/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/omnara-ai%2Fomnara/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":273417342,"owners_count":25101817,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-09-03T02:00:09.631Z","response_time":76,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-08-14T23:02:21.056Z","updated_at":"2025-09-03T09:04:41.548Z","avatar_url":"https://github.com/omnara-ai.png","language":"Python","funding_links":[],"categories":["Alternative Clients 📱","TypeScript","HarmonyOS","Code \u0026 Developer Tools","Multi-Agent \u0026 Orchestration","替代客户端 📱"],"sub_categories":["General","Windows Manager","Other IDEs","通用"],"readme":"# Omnara - Mission Control for Your AI Agents 🚀\n\n\u003cdiv align=\"center\"\u003e\n\n**Your AI workforce, in your pocket.**\n\n[![PyPI version](https://badge.fury.io/py/omnara.svg)](https://badge.fury.io/py/omnara)\n[![Downloads](https://pepy.tech/badge/omnara)](https://pepy.tech/project/omnara)\n[![Python Versions](https://img.shields.io/pypi/pyversions/omnara.svg)](https://pypi.org/project/omnara/)\n[![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)\n[![GitHub stars](https://img.shields.io/github/stars/omnara-ai/omnara?style=social)](https://github.com/omnara-ai/omnara)\n[![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)\n\n\u003c/div\u003e\n\n![Omnara Mobile Experience](./docs/assets/three-panel.png)\n\n\u003cdiv align=\"center\"\u003e\n\n[📱 **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)\n\n\u003c/div\u003e\n\n---\n\n## 🚀 Quick Start\n\n```bash\n# Install Omnara\npip install omnara\n\n# Start a Claude Code session that's synced between terminal, web, and mobile\nomnara\n```\n\nThat'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).\n\n## 💡 What is Omnara?\n\nOmnara 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.\n\n\n### 🎬 See It In Action\n\n![Agent Activity Feed](./docs/assets/Mobile-app-showcase.gif)\n\n## 📖 How to Use\n\n### 1. Omnara CLI\n\u003cdetails\u003e\n\u003csummary\u003eThe primary way to use Claude Code with Omnara\u003c/summary\u003e\n\n#### Installation\n\nInstall Omnara using your preferred package manager:\n\n```bash\n# Using pip\npip install omnara\n\n# Using uv\nuv tool install omnara\n\n# Using pipx\npipx install omnara\n```\n\n#### Running Omnara\n\nOmnara offers three different modes depending on your workflow:\n\n##### **Standard Mode** - Full Claude Code Experience\n```bash\nomnara\n```\nStarts 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.\n\n##### **Headless Mode** - Dashboard-Only Interaction\n```bash\nomnara headless\n```\nRuns 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.\n\n##### **Server Mode** - Remote Launch Capability\n```bash\nomnara serve\n```\nExposes 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.\n\n#### Upgrading\n\nKeep Omnara up-to-date with the latest features:\n\n```bash\n# Using pip\npip install omnara --upgrade\n\n# Using uv\nuv tool upgrade omnara\n\n# Using pipx\npipx upgrade omnara\n```\n\n\u003c/details\u003e\n\n### 2. n8n Integration\n\u003cdetails\u003e\n\u003csummary\u003eAdd human-in-the-loop capabilities to your n8n workflows\u003c/summary\u003e\n\n#### What it Does\n\nThe 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.\n\n\n#### Installation \u0026 Setup\n\nFor detailed installation and configuration instructions, see the [n8n-nodes-omnara package](https://www.npmjs.com/package/n8n-nodes-omnara) on npm.\n\n\u003c/details\u003e\n\n### 3. GitHub Actions Integration\n\u003cdetails\u003e\n\u003csummary\u003eRun Claude Code in GitHub Actions with Omnara monitoring\u003c/summary\u003e\n\n#### What it Does\n\nThe 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.\n\n#### Key Features\n\n- **Remote Launch**: Start GitHub Actions from your phone or web dashboard\n- **Automatic PR Creation**: Claude creates branches, commits changes, and opens PRs\n- **Real-time Monitoring**: Track progress and provide guidance through Omnara\n\n#### Installation \u0026 Setup\n\nFor complete setup instructions including GitHub workflow configuration, see the [GitHub Actions integration guide](./integrations/github/claude-code-action/README.md).\n\n\u003c/details\u003e\n\n## 🔧 Integrating your own Agent into Omnara\n\n\n### Method 1: Manual MCP Configuration\n\nFor custom MCP setups, you can configure manually:\n\n```json\n{\n  \"mcpServers\": {\n    \"omnara\": {\n      \"command\": \"pipx\",\n      \"args\": [\"run\", \"--no-cache\", \"omnara\", \"mcp\", \"--api-key\", \"YOUR_API_KEY\"]\n    }\n  }\n}\n```\n\n### Method 2: Python SDK\n```python\nfrom omnara import OmnaraClient\nimport uuid\n\nclient = OmnaraClient(api_key=\"your-api-key\")\ninstance_id = str(uuid.uuid4())\n\n# Log progress and check for user feedback\nresponse = client.send_message(\n    agent_type=\"claude-code\",\n    content=\"Analyzing codebase structure\",\n    agent_instance_id=instance_id,\n    requires_user_input=False\n)\n\n# Ask for user input when needed\nanswer = client.send_message(\n    content=\"Should I refactor this legacy module?\",\n    agent_instance_id=instance_id,\n    requires_user_input=True\n)\n```\n\n### Method 3: REST API\n```bash\ncurl -X POST https://api.omnara.com/api/v1/messages/agent \\\n  -H \"Authorization: Bearer YOUR_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"content\": \"Starting deployment process\", \"agent_type\": \"claude-code\", \"requires_user_input\": false}'\n```\n\n## 🏗️ Architecture Overview\n\nOmnara provides a unified platform for monitoring and controlling your AI agents:\n\n```mermaid\ngraph TB\n    subgraph \"Your AI Agents\"\n        A[🤖 AI Agents\u003cbr/\u003eClaude Code, Cursor, etc.]\n    end\n\n    subgraph \"Omnara Platform\"\n        API[🌐 API Server]\n        DB[(📊 PostgreSQL)]\n        NOTIFY[🔔 Notification Service\u003cbr/\u003ePush/Email/SMS]\n    end\n\n    subgraph \"Your Devices\"\n        M[📱 Mobile App]\n        W[💻 Web Dashboard]\n    end\n\n    A --\u003e|Send updates| API\n    API --\u003e|Store data| DB\n    API --\u003e|Trigger notifications| NOTIFY\n    NOTIFY --\u003e|Alert users| M\n    DB --\u003e|Real-time sync| M\n    DB --\u003e|Real-time sync| W\n    M --\u003e|User responses| API\n    W --\u003e|User responses| API\n    API --\u003e|Deliver feedback| A\n\n    style A fill:#e3f2fd,stroke:#1976d2,stroke-width:3px,color:#000\n    style API fill:#c8e6c9,stroke:#388e3c,stroke-width:2px,color:#000\n    style DB fill:#ffccbc,stroke:#d84315,stroke-width:2px,color:#000\n    style NOTIFY fill:#fff59d,stroke:#f57f17,stroke-width:2px,color:#000\n    style M fill:#f8bbd0,stroke:#c2185b,stroke-width:3px,color:#000\n    style W fill:#f8bbd0,stroke:#c2185b,stroke-width:3px,color:#000\n```\n\n### For Developers\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003e🛠️ Development Setup\u003c/b\u003e\u003c/summary\u003e\n\n**Prerequisites:** Docker, Python 3.10+, Node.js\n\n**Quick Start:**\n```bash\ngit clone https://github.com/omnara-ai/omnara\ncd omnara\ncp .env.example .env\npython scripts/generate_jwt_keys.py\n./dev-start.sh  # Starts everything automatically\n```\n\n**Stop services:** `./dev-stop.sh`\n\nFor detailed setup instructions, manual configuration, and contribution guidelines, see our [Contributing Guide](CONTRIBUTING.md).\n\n\u003c/details\u003e\n\n## 🤝 Contributing\n\nWe love contributions! Check out our [Contributing Guide](CONTRIBUTING.md) to get started.\n\n### Development Commands\n```bash\nmake lint       # Run code quality checks\nmake format     # Auto-format code\nmake test       # Run test suite\n./dev-start.sh  # Start development servers\n```\n\n## 📊 Pricing\n\n| Plan | Price | Features |\n|------|-------|----------|\n| **Free** | $0/mo | 10 agents/month, Core features |\n| **Pro** | $9/mo | Unlimited agents, Priority support |\n| **Enterprise** | [Contact Us](https://cal.com/ishaan-sehgal-8kc22w/omnara-demo) | Teams, SSO, Custom integrations |\n\n## 🆘 Support\n\n- 💬 [GitHub Discussions](https://github.com/omnara-ai/omnara/discussions)\n- 🐛 [Report Issues](https://github.com/omnara-ai/omnara/issues)\n- 📧 [Email Support](mailto:ishaan@omnara.com)\n- 📖 Documentation (coming soon)\n\n## 📜 License\n\nOmnara is open source software licensed under the [Apache 2.0 License](LICENSE).\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n**Built with ❤️ by the Omnara team**\n\n[Website](https://omnara.com) • [Twitter](https://twitter.com/omnaraai) • [LinkedIn](https://linkedin.com/company/omnara)\n\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fomnara-ai%2Fomnara","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fomnara-ai%2Fomnara","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fomnara-ai%2Fomnara/lists"}