opendia

<p align="center"> <img src="../docs/assets/hero-animated.svg" alt="OpenDia — connect your browser to AI models. The open alternative to Dia / Perplexity Comet: 18 browser tools over MCP, works on any Chromium browser and Firefox, private and local-first." width="100%" /> </p> <p align="center"> <strong>Star us&nbsp;❤️&nbsp;→</strong>&nbsp;&nbsp; <a href="https://github.com/aeonfun/opendia/stargazers"><img src="../docs/assets/btn-star.svg" alt="Star OpenDia on GitHub" height="34" align="absmiddle"></a>&nbsp;&nbsp; <a href="https://www.npmjs.com/package/opendia"><img src="../docs/assets/btn-npm.svg" alt="opendia on npm" height="34" align="absmiddle"></a>&nbsp;&nbsp; <a href="https://x.com/aeonframework"><img src="../docs/assets/btn-x.svg" alt="@aeonframework on X" height="34" align="absmiddle"></a>&nbsp;&nbsp; <a href="https://bankr.bot/discover/0xbf8e8f0e8866a7052f948c16508644347c57aba3"><img src="../docs/assets/btn-bankr.svg" alt="$aeon on Bankr" height="34" align="absmiddle"></a> </p> <p align="center"> <strong>The open alternative to Dia / Perplexity Comet.</strong><br> Connect your browser to AI models &mdash; no browser switching needed.<br> Works seamlessly with Chrome, Firefox, and any Chromium browser. Private, local-first &amp; MCP focused. </p> <div align="center"> [](https://github.com/aeonfun/opendia/stargazers) [](https://github.com/aeonfun/opendia/network/members) [](https://www.npmjs.com/package/opendia) [](../LICENSE) </div> <p align="center"> <img src="../preview.gif" alt="OpenDia Demo" /> </p> <p align="center"> _{New to MCPs, or not technical? We recommend <a href="https://pplx.ai/leosimon">Perplexity Comet</a>.} </p> --- ## 🚀 What is OpenDia? OpenDia lets AI models control your browser automatically. **The key advantage? It leverages everything you already have**—your logged-in accounts, saved passwords, cookies, wallets, and browsing history. No need to start from scratch or switch contexts. **🔑 Use Your Existing Digital Life:** - ✅ **Logged-in accounts**: Post to Twitter/X, LinkedIn, Facebook with your existing sessions - ✅ **Browser data**: Access your bookmarks, history, and saved passwords - ✅ **Extensions & wallets**: Use MetaMask, password managers, or any installed extensions - ✅ **Cookies & sessions**: Stay authenticated across all your favorite sites - ✅ **Local testing**: Perfect for development with Cursor - test with real user sessions **✨ Key Benefits:** - 🔄 **Universal AI Support**: Works with Claude, ChatGPT, Cursor, Grok Build and even local models - 🎯 **Anti-Detection**: Specialized bypasses for Twitter/X, LinkedIn, Facebook - 📱 **Smart Automation**: AI understands your pages and finds the right elements - 🛡️ **Privacy-First**: Everything runs locally, your data stays with you - ⚡ **Zero Setup**: Get started with one command ## 🌐 Browser Support Works with **Chrome, Firefox, and any Chromium-based browser**: - ✅ **Google Chrome** - ✅ **Arc** - ✅ **Mozilla Firefox** - ✅ **Microsoft Edge** - ✅ **Brave** - ✅ **Opera** - ✅ **Any Chromium based browser** Also perfect for **Cursor users** who want to automate their local testing and development workflows! ## 🔌 Compatible AI Clients OpenDia exposes a standard MCP server, so it works with any client that speaks the protocol. **Tested:** - **Claude Desktop** — paste the config below, restart. - **Claude Code** — same MCP config, runs from any terminal. - **Cursor** — add via Settings → MCP, or paste the same JSON. - **Grok Build** — install the OpenDia plugin or add the MCP block to `~/.grok/config.toml` (see [Grok Build](#grok-build) below). - **ChatGPT** — works with Auto-Tunnel mode (`npx opendia --tunnel`), then add the ngrok URL as a connector. **Should work** (any MCP-compatible client): Windsurf, Zed, Continue, Cline, Goose, Open WebUI. Wired it up with something else? Open a PR — the list grows as MCP grows. ## 🎬 What You Can Do **Real workflows you can try today:** ### 📰 Content & Social Media - **"Summarize all the articles I read today and post a Twitter thread about the key insights"** - **"Find interesting articles related to AI from my bookmarks and create a reading list"** - **"Read this article and post a thoughtful comment on the LinkedIn version"** - **"Check my recent Twitter bookmarks and summarize the main themes"** ### 📧 Productivity & Research - **"Browse my latest emails and tell me what needs urgent attention"** - **"Find all the GitHub repos I visited this week and create a summary report"** - **"Extract the main points from this research paper and save them to my notes"** - **"Search my browsing history for that article about AI safety I read last month"** ### 🤖 Development & Testing (Perfect for Cursor!) - **"Test my web app's signup flow and take screenshots at each step"** - **"Fill out this form with test data and check if validation works"** - **"Navigate through my app and check if all the buttons work properly"** - **"Use my connected wallet to test this DeFi interface"** ### 🔄 Advanced Automation - **"Open tabs for all my daily news sources and summarize the top stories"** - **"Draft replies to my unread messages based on the context"** - **"Monitor this webpage and notify me when the content changes"** - **"Automatically bookmark interesting articles I'm reading"** ### 🎨 Visual Customization & Fun - **"Apply a cyberpunk theme to this documentation site to make it more engaging"** - **"Make this page dark mode with green text for late-night reading"** - **"Add rainbow party effects to celebrate finishing this project"** - **"Transform this boring form with a retro 80s theme while I fill it out"** - **"Use high contrast styling so I can read this better"** ## ⚡ Quick Start ### 1. Install the Browser Extension **For Chrome/Chromium browsers:** 1. Download the latest `opendia-chrome-*.zip` from [releases](https://github.com/aeonfun/opendia/releases) 2. Extract the zip file to a folder 3. Go to `chrome://extensions/` (or your browser's extension page) 4. Enable "Developer mode" 5. Click "Load unpacked" and select the extracted folder **For Firefox:** 1. Download the latest `opendia-firefox-*.zip` from [releases](https://github.com/aeonfun/opendia/releases) 2. Extract the zip file to a folder 3. Go to `about:debugging#/runtime/this-firefox` 4. Click "Load Temporary Add-on..." 5. Select the `manifest.json` file from the extracted folder > **Note**: Firefox extensions are loaded as temporary add-ons and will be removed when Firefox restarts. This is a Firefox limitation for unsigned extensions. ### 2. Connect to Your AI **Option 1: Double-click Installation (Recommended)** 1. Download the `opendia.dxt` file from [releases](https://github.com/aeonfun/opendia/releases) 2. Double-click the `.dxt` file to install automatically 3. The MCP will be added to your Claude Desktop configuration The DXT settings in Claude Desktop (WebSocket Port, HTTP Port, Auto-Tunnel, Tunnel Auth Token) are passed to the server as the `OPENDIA_*` environment variables described under [Port Configuration](#port-configuration). If you move the HTTP port outside the ports the extension checks (5556-5558, 3001, 6001-6003), enter it under **Custom HTTP Port** in the extension popup. Safety Mode is a toggle in the extension popup, not a DXT setting. **Option 2: Manual Configuration** Add to your Claude Desktop configuration: ```json { "mcpServers": { "opendia": { "command": "npx", "args": ["opendia"] } } } ``` **For Cursor or other AI tools**, use the same configuration or follow their specific setup instructions. ### Grok Build OpenDia ships a first-class **Grok Build plugin** under [`plugins/opendia/`](../plugins/opendia) (marketplace index: [`.grok-plugin/marketplace.json`](../.grok-plugin/marketplace.json)). **Option A — Plugin (recommended)** ```bash grok plugin marketplace add aeonfun/opendia grok plugin install opendia --trust ``` Enable the plugin in `/plugins` (trust is required for MCP). Details, skills, and troubleshooting: [`plugins/opendia/README.md`](../plugins/opendia/README.md). **Option B — Manual `config.toml`** Add to `~/.grok/config.toml` (or a project `.grok/config.toml`): ```toml [mcp_servers.opendia] command = "npx" args = ["-y", "opendia"] enabled = true startup_timeout_sec = 60 ``` Then install the browser extension and confirm it is connected to `ws://localhost:5555`. ```bash grok mcp doctor opendia ``` ## Usage Modes ### Local Mode (Default) ```bash npx opendia ``` - Chrome extension: ws://localhost:5555 (auto-discovery enabled) - Claude Desktop: stdio (existing config) - Local SSE: http://localhost:5556/sse ### Port Configuration ```bash # Use custom ports npx opendia --port=6000 # Uses 6000 (WebSocket) + 6001 (HTTP) npx opendia --ws-port=5555 --http-port=5556 # Specify individually # Handle port conflicts # Note: Existing OpenDia processes are automatically terminated on startup ``` The same settings can come from environment variables, which is how the Claude Desktop DXT applies its settings. A command-line flag always wins over the matching variable, and an empty variable counts as unset. | Variable | Same as | Notes | | --- | --- | --- | | `OPENDIA_WS_PORT` | `--ws-port=` | Integer 1-65535 | | `OPENDIA_HTTP_PORT` | `--http-port=` | Integer 1-65535 | | `OPENDIA_ENABLE_TUNNEL` | `--tunnel` | `1`, `true` or `yes` turns it on | | `OPENDIA_TOKEN` | `--token=` | Bearer token for tunnel mode | The browser extension finds the server by checking HTTP ports 5556-5558, 3001 and 6001-6003. For any other HTTP port, enter it under **Custom HTTP Port** in the extension popup so it is checked first. ### Auto-Tunnel Mode ```bash npx opendia --tunnel ``` - Automatically creates ngrok tunnel - Copy URL for ChatGPT/online AI services - Local functionality preserved Because the tunnel is public, `/sse` requires a bearer token in this mode. The server prints one at startup; pass `--token=<value>` (or set `OPENDIA_TOKEN`) to pin a fixed one across restarts. Send it with every request: ```bash curl -H "Authorization: Bearer <token>" https://<tunnel>.ngrok-free.app/sse ``` ### Network Binding Both listeners bind `127.0.0.1` by default, and `ngrok` connects from this machine, so the tunnel works without widening anything. To expose the HTTP/SSE port on the LAN deliberately: ```bash npx opendia --http-host=0.0.0.0 # requires a token, same as --tunnel ``` The WebSocket extension channel always stays on loopback. **Note**: For auto-tunneling to work, you need ngrok installed: **macOS:** ```bash brew install ngrok ``` **Windows:** ```bash # Using Chocolatey choco install ngrok # Or download from https://ngrok.com/download ``` **Linux:** ```bash # Ubuntu/Debian curl -s https://ngrok-agent.s3.amazonaws.com/ngrok.asc | sudo tee /etc/apt/trusted.gpg.d/ngrok.asc >/dev/null echo "deb https://ngrok-agent.s3.amazonaws.com buster main" | sudo tee /etc/apt/sources.list.d/ngrok.list sudo apt update && sudo apt install ngrok # Or download from https://ngrok.com/download ``` Then get your free authtoken from https://dashboard.ngrok.com/get-started/your-authtoken and run: ```bash ngrok config add-authtoken YOUR_TOKEN_HERE ``` ## 🛠️ Capabilities OpenDia gives AI models **18 powerful browser tools**: ### 🎯 Smart Page Understanding - **Analyze any webpage** - AI automatically finds buttons, forms, and interactive elements - **Extract content intelligently** - Get clean text from articles, social posts, or search results - **Understand context** - AI knows what type of page it's looking at and how to interact with it ### 🖱️ Natural Interactions - **Click anything** - Buttons, links, menus - AI finds and clicks the right elements - **Fill forms smartly** - Works even on complex sites like Twitter, LinkedIn, Facebook - **Navigate seamlessly** - Go to pages, scroll, wait for content to load - **Handle modern web apps** - Bypasses detection on social platforms ### 📑 Tab & Window Management - **Multi-tab workflows** - Open, close, switch between tabs automatically - **Organize your workspace** - Let AI manage your browser tabs efficiently - **Coordinate complex tasks** - Work across multiple sites simultaneously ### 📊 Access Your Browser Data - **Bookmarks & History** - Find that article you read last week - **Current page content** - Get selected text, links, or full page content - **Real-time information** - Work with whatever's currently on your screen ### 🛡️ Anti-Detection Features - **Social media posting** - Bypass automation detection on Twitter/X, LinkedIn, Facebook - **Natural interactions** - Mimics human behavior to avoid triggering security measures - **Reliable automation** - Works consistently even on sites that block typical automation tools ### 🎨 Page Styling & Customization - **Transform any website** - Apply fun themes, custom colors, and visual effects - **Preset themes** - Dark hacker, retro 80s, rainbow party, minimalist zen, and more - **AI mood styling** - Describe a mood and get matching visual design - **Interactive effects** - Matrix rain, floating particles, neon glow, and cursor trails - **Accessibility themes** - High contrast and readable designs for better visibility ## 💬 Example Prompts to Try Once everything is set up, try asking your AI: **Content Creation:** > *"Read the article on this page and create a Twitter thread summarizing the main points"* **Research & Analysis:** > *"Look through my browser history from this week and find articles about machine learning. Summarize the key trends."* **Social Media Management:** > *"Check my Twitter bookmarks and organize them into categories. Create a summary of each category."* **Productivity:** > *"Open tabs for my usual morning reading sites and give me a briefing of today's top stories"* **Development Testing:** > *"Fill out this contact form with test data and check if the submission works properly"* **Personal Assistant:** > *"Find that GitHub repo I was looking at yesterday about React components and bookmark it for later"* **Page Styling & Fun:** > *"Apply a dark hacker theme to this page to make it look more interesting"* > *"Make this boring documentation page feel like a cozy coffee shop"* > *"Add some matrix rain effects to this page for 30 seconds for a cool screenshot"* > *"Transform this page with a high contrast theme for better readability"* ## 🏗️ How It Works ```mermaid graph LR A[AI Model] --> B[OpenDia Server] B --> C[Browser Extension] C --> D[Your Browser] D --> E[Any Website] ``` 1. **You ask** your AI to do something browser-related 2. **AI calls** OpenDia tools to understand and interact with pages 3. **OpenDia controls** your browser through the extension 4. **You get results** - AI can see what happened and respond intelligently ## 🔒 Security & Privacy **Your data stays private**: - ✅ **Everything runs locally** - No cloud processing of your browsing data - ✅ **You control access** - Extension only works when you want it to - ✅ **Open source** - Full transparency of what the code does - ✅ **No tracking** - We don't collect or store any of your information **Important**: This tool requires broad browser permissions to function. Only use with AI models you trust, and in environments where you're comfortable with browser automation. ## 🤝 Contributing Love to have your help making OpenDia better! ### Quick Development Setup ```bash git clone https://github.com/aeonfun/opendia.git cd opendia # Start the server cd opendia-mcp npm install npm start # Load extension in your browser # Chrome: Go to chrome://extensions/ → Developer mode → Load unpacked: ./opendia-extension/dist/chrome # Firefox: Go to about:debugging#/runtime/this-firefox → Load Temporary Add-on → ./opendia-extension/dist/firefox/manifest.json # Extension will auto-connect to server on localhost:5555 ``` ### Ways to Contribute - 🐛 **Report bugs** via [GitHub Issues](https://github.com/aeonfun/opendia/issues) - 💡 **Share it on social medias** - 🔧 **Add new browser capabilities** - 📖 **Improve documentation** - 🧪 **Test with different AI models** ## 📝 License MIT License - see [LICENSE](../LICENSE) for details. --- **Ready to supercharge your browser with AI? Get started with `npx opendia`! 🚀** --- Built by [Aaron Elijah Mars](https://aaronjmars.com), founder of Aeon and MiroShark · [@aaronjmars](https://github.com/aaronjmars)