{"id":28923695,"url":"https://github.com/aaronjmars/opendia","last_synced_at":"2025-10-13T12:11:55.400Z","repository":{"id":298969749,"uuid":"1000277419","full_name":"aaronjmars/opendia","owner":"aaronjmars","description":"No need to switch browsers, just use Dia on Chrome or on Arc.","archived":false,"fork":false,"pushed_at":"2025-06-29T05:35:49.000Z","size":27731,"stargazers_count":21,"open_issues_count":0,"forks_count":4,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-06-29T06:34:31.072Z","etag":null,"topics":["automation","chrome-extension","dia","mcp","npm","npm-package"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/aaronjmars.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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}},"created_at":"2025-06-11T14:28:15.000Z","updated_at":"2025-06-29T06:12:54.000Z","dependencies_parsed_at":"2025-06-13T22:31:47.084Z","dependency_job_id":"0a10387e-5f42-4b4f-b282-eda0250149a0","html_url":"https://github.com/aaronjmars/opendia","commit_stats":null,"previous_names":["aaronjmars/opendia"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/aaronjmars/opendia","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aaronjmars%2Fopendia","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aaronjmars%2Fopendia/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aaronjmars%2Fopendia/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aaronjmars%2Fopendia/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/aaronjmars","download_url":"https://codeload.github.com/aaronjmars/opendia/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aaronjmars%2Fopendia/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262950351,"owners_count":23389644,"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","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":["automation","chrome-extension","dia","mcp","npm","npm-package"],"created_at":"2025-06-22T09:39:58.286Z","updated_at":"2025-10-13T12:11:55.395Z","avatar_url":"https://github.com/aaronjmars.png","language":"JavaScript","readme":"# OpenDia \u003cimg src=\"opendia-extension/icons/icon-128.png\" alt=\"OpenDia\" width=\"32\" height=\"32\"\u003e\n\n**The open alternative to Dia / Perplexity Comet**  \nConnect your browser to AI models. \nNo browser switching needed—works seamlessly with Chrome, Firefox, and any Chromium browser. Private, local-first \u0026 MCP focused.\nIf you are not technical / never used MCPs before, we recommend using **[Perplexity Comet](https://pplx.ai/leosimon)**.\n\n[![npm version](https://img.shields.io/npm/v/opendia)](https://www.npmjs.com/package/opendia)\n[![GitHub release](https://img.shields.io/github/release/aaronjmars/opendia.svg)](https://github.com/aaronjmars/opendia/releases/latest)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\n## 📺 See it in Action\n\n![OpenDia Demo](./preview.gif)\n\n## 🚀 What is OpenDia?\n\nOpenDia 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.\n\n**🔑 Use Your Existing Digital Life:**\n- ✅ **Logged-in accounts**: Post to Twitter/X, LinkedIn, Facebook with your existing sessions\n- ✅ **Browser data**: Access your bookmarks, history, and saved passwords\n- ✅ **Extensions \u0026 wallets**: Use MetaMask, password managers, or any installed extensions\n- ✅ **Cookies \u0026 sessions**: Stay authenticated across all your favorite sites\n- ✅ **Local testing**: Perfect for development with Cursor - test with real user sessions\n\n**✨ Key Benefits:**\n- 🔄 **Universal AI Support**: Works with Claude, ChatGPT, Cursor and even local models\n- 🎯 **Anti-Detection**: Specialized bypasses for Twitter/X, LinkedIn, Facebook\n- 📱 **Smart Automation**: AI understands your pages and finds the right elements\n- 🛡️ **Privacy-First**: Everything runs locally, your data stays with you\n- ⚡ **Zero Setup**: Get started with one command\n\n## 🌐 Browser Support\n\nWorks with **Chrome, Firefox, and any Chromium-based browser**:\n- ✅ **Google Chrome**\n- ✅ **Arc**\n- ✅ **Mozilla Firefox**\n- ✅ **Microsoft Edge**\n- ✅ **Brave**\n- ✅ **Opera**\n- ✅ **Any Chromium based browser**\n\nAlso perfect for **Cursor users** who want to automate their local testing and development workflows!\n\n## 🎬 What You Can Do\n\n**Real workflows you can try today:**\n\n### 📰 Content \u0026 Social Media\n- **\"Summarize all the articles I read today and post a Twitter thread about the key insights\"**\n- **\"Find interesting articles related to AI from my bookmarks and create a reading list\"**\n- **\"Read this article and post a thoughtful comment on the LinkedIn version\"**\n- **\"Check my recent Twitter bookmarks and summarize the main themes\"**\n\n### 📧 Productivity \u0026 Research\n- **\"Browse my latest emails and tell me what needs urgent attention\"**\n- **\"Find all the GitHub repos I visited this week and create a summary report\"**\n- **\"Extract the main points from this research paper and save them to my notes\"**\n- **\"Search my browsing history for that article about AI safety I read last month\"**\n\n### 🤖 Development \u0026 Testing (Perfect for Cursor!)\n- **\"Test my web app's signup flow and take screenshots at each step\"**\n- **\"Fill out this form with test data and check if validation works\"**\n- **\"Navigate through my app and check if all the buttons work properly\"**\n- **\"Use my connected wallet to test this DeFi interface\"**\n\n### 🔄 Advanced Automation\n- **\"Open tabs for all my daily news sources and summarize the top stories\"**\n- **\"Draft replies to my unread messages based on the context\"**\n- **\"Monitor this webpage and notify me when the content changes\"**\n- **\"Automatically bookmark interesting articles I'm reading\"**\n\n### 🎨 Visual Customization \u0026 Fun\n- **\"Apply a cyberpunk theme to this documentation site to make it more engaging\"**\n- **\"Make this page dark mode with green text for late-night reading\"**\n- **\"Add rainbow party effects to celebrate finishing this project\"**\n- **\"Transform this boring form with a retro 80s theme while I fill it out\"**\n- **\"Use high contrast styling so I can read this better\"**\n\n## ⚡ Quick Start\n\n### 1. Install the Browser Extension\n\n**For Chrome/Chromium browsers:**\n1. Download `opendia-chrome-1.1.0.zip` from [releases](https://github.com/aaronjmars/opendia/releases)\n2. Extract the zip file to a folder\n3. Go to `chrome://extensions/` (or your browser's extension page)\n4. Enable \"Developer mode\"\n5. Click \"Load unpacked\" and select the extracted folder\n\n**For Firefox:**\n1. Download `opendia-firefox-1.1.0.zip` from [releases](https://github.com/aaronjmars/opendia/releases)\n2. Extract the zip file to a folder\n3. Go to `about:debugging#/runtime/this-firefox`\n4. Click \"Load Temporary Add-on...\"\n5. Select the `manifest.json` file from the extracted folder\n\n\u003e **Note**: Firefox extensions are loaded as temporary add-ons and will be removed when Firefox restarts. This is a Firefox limitation for unsigned extensions.\n\n### 2. Connect to Your AI\n\n**Option 1: Double-click Installation (Recommended)**\n1. Download the `opendia.dxt` file from [releases](https://github.com/aaronjmars/opendia/releases)\n2. Double-click the `.dxt` file to install automatically\n3. The MCP will be added to your Claude Desktop configuration\n\n**Option 2: Manual Configuration**\nAdd to your Claude Desktop configuration:\n```json\n{\n  \"mcpServers\": {\n    \"opendia\": {\n      \"command\": \"npx\",\n      \"args\": [\"opendia\"]\n    }\n  }\n}\n```\n\n**For Cursor or other AI tools**, use the same configuration or follow their specific setup instructions.\n\n## Usage Modes\n\n### Local Mode (Default)\n```bash\nnpx opendia\n```\n- Chrome extension: ws://localhost:5555 (auto-discovery enabled)\n- Claude Desktop: stdio (existing config)\n- Local SSE: http://localhost:5556/sse\n\n### Port Configuration\n```bash\n# Use custom ports\nnpx opendia --port=6000              # Uses 6000 (WebSocket) + 6001 (HTTP)\nnpx opendia --ws-port=5555 --http-port=5556  # Specify individually\n\n# Handle port conflicts  \n# Note: Existing OpenDia processes are automatically terminated on startup\n```\n\n### Auto-Tunnel Mode\n```bash\nnpx opendia --tunnel\n```\n- Automatically creates ngrok tunnel\n- Copy URL for ChatGPT/online AI services\n- Local functionality preserved\n\n**Note**: For auto-tunneling to work, you need ngrok installed:\n\n**macOS:**\n```bash\nbrew install ngrok\n```\n\n**Windows:**\n```bash\n# Using Chocolatey\nchoco install ngrok\n\n# Or download from https://ngrok.com/download\n```\n\n**Linux:**\n```bash\n# Ubuntu/Debian\ncurl -s https://ngrok-agent.s3.amazonaws.com/ngrok.asc | sudo tee /etc/apt/trusted.gpg.d/ngrok.asc \u003e/dev/null\necho \"deb https://ngrok-agent.s3.amazonaws.com buster main\" | sudo tee /etc/apt/sources.list.d/ngrok.list\nsudo apt update \u0026\u0026 sudo apt install ngrok\n\n# Or download from https://ngrok.com/download\n```\n\nThen get your free authtoken from https://dashboard.ngrok.com/get-started/your-authtoken and run:\n```bash\nngrok config add-authtoken YOUR_TOKEN_HERE\n```\n\n## 🛠️ Capabilities\n\nOpenDia gives AI models **18 powerful browser tools**:\n\n### 🎯 Smart Page Understanding\n- **Analyze any webpage** - AI automatically finds buttons, forms, and interactive elements\n- **Extract content intelligently** - Get clean text from articles, social posts, or search results\n- **Understand context** - AI knows what type of page it's looking at and how to interact with it\n\n### 🖱️ Natural Interactions  \n- **Click anything** - Buttons, links, menus - AI finds and clicks the right elements\n- **Fill forms smartly** - Works even on complex sites like Twitter, LinkedIn, Facebook\n- **Navigate seamlessly** - Go to pages, scroll, wait for content to load\n- **Handle modern web apps** - Bypasses detection on social platforms\n\n### 📑 Tab \u0026 Window Management\n- **Multi-tab workflows** - Open, close, switch between tabs automatically\n- **Organize your workspace** - Let AI manage your browser tabs efficiently\n- **Coordinate complex tasks** - Work across multiple sites simultaneously\n\n### 📊 Access Your Browser Data\n- **Bookmarks \u0026 History** - Find that article you read last week\n- **Current page content** - Get selected text, links, or full page content\n- **Real-time information** - Work with whatever's currently on your screen\n\n### 🛡️ Anti-Detection Features\n- **Social media posting** - Bypass automation detection on Twitter/X, LinkedIn, Facebook\n- **Natural interactions** - Mimics human behavior to avoid triggering security measures\n- **Reliable automation** - Works consistently even on sites that block typical automation tools\n\n### 🎨 Page Styling \u0026 Customization\n- **Transform any website** - Apply fun themes, custom colors, and visual effects\n- **Preset themes** - Dark hacker, retro 80s, rainbow party, minimalist zen, and more\n- **AI mood styling** - Describe a mood and get matching visual design\n- **Interactive effects** - Matrix rain, floating particles, neon glow, and cursor trails\n- **Accessibility themes** - High contrast and readable designs for better visibility\n\n## 💬 Example Prompts to Try\n\nOnce everything is set up, try asking your AI:\n\n**Content Creation:**\n\u003e *\"Read the article on this page and create a Twitter thread summarizing the main points\"*\n\n**Research \u0026 Analysis:**\n\u003e *\"Look through my browser history from this week and find articles about machine learning. Summarize the key trends.\"*\n\n**Social Media Management:**\n\u003e *\"Check my Twitter bookmarks and organize them into categories. Create a summary of each category.\"*\n\n**Productivity:**\n\u003e *\"Open tabs for my usual morning reading sites and give me a briefing of today's top stories\"*\n\n**Development Testing:**\n\u003e *\"Fill out this contact form with test data and check if the submission works properly\"*\n\n**Personal Assistant:**\n\u003e *\"Find that GitHub repo I was looking at yesterday about React components and bookmark it for later\"*\n\n**Page Styling \u0026 Fun:**\n\u003e *\"Apply a dark hacker theme to this page to make it look more interesting\"*\n\n\u003e *\"Make this boring documentation page feel like a cozy coffee shop\"*\n\n\u003e *\"Add some matrix rain effects to this page for 30 seconds for a cool screenshot\"*\n\n\u003e *\"Transform this page with a high contrast theme for better readability\"*\n\n## 🏗️ How It Works\n\n```mermaid\ngraph LR\n    A[AI Model] --\u003e B[OpenDia Server]\n    B --\u003e C[Browser Extension]\n    C --\u003e D[Your Browser]\n    D --\u003e E[Any Website]\n```\n\n1. **You ask** your AI to do something browser-related\n2. **AI calls** OpenDia tools to understand and interact with pages\n3. **OpenDia controls** your browser through the extension\n4. **You get results** - AI can see what happened and respond intelligently\n\n## 🔒 Security \u0026 Privacy\n\n**Your data stays private**:\n- ✅ **Everything runs locally** - No cloud processing of your browsing data\n- ✅ **You control access** - Extension only works when you want it to\n- ✅ **Open source** - Full transparency of what the code does\n- ✅ **No tracking** - We don't collect or store any of your information\n\n**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.\n\n## 🤝 Contributing\n\nLove to have your help making OpenDia better!\n\n### Quick Development Setup\n```bash\ngit clone https://github.com/aaronjmars/opendia.git\ncd opendia\n\n# Start the server\ncd opendia-mcp\nnpm install\nnpm start\n\n# Load extension in your browser  \n# Chrome: Go to chrome://extensions/ → Developer mode → Load unpacked: ./opendia-extension/dist/chrome\n# Firefox: Go to about:debugging#/runtime/this-firefox → Load Temporary Add-on → ./opendia-extension/dist/firefox/manifest.json\n# Extension will auto-connect to server on localhost:5555\n```\n\n### Ways to Contribute\n- 🐛 **Report bugs** via [GitHub Issues](https://github.com/aaronjmars/opendia/issues)\n- 💡 **Share it on social medias**\n- 🔧 **Add new browser capabilities** \n- 📖 **Improve documentation**\n- 🧪 **Test with different AI models**\n\n## 📝 License\n\nMIT License - see [LICENSE](LICENSE) for details.\n\n---\n\n**Ready to supercharge your browser with AI? Get started with `npx opendia`! 🚀**\n","funding_links":[],"categories":["A01_文本生成_文本对话","📚 Projects (1974 total)","MCP Servers","JavaScript"],"sub_categories":["大语言对话模型及数据","MCP Servers","Browser Automation"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faaronjmars%2Fopendia","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faaronjmars%2Fopendia","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faaronjmars%2Fopendia/lists"}