{"id":30020387,"url":"https://github.com/milisp/plux","last_synced_at":"2026-04-20T10:32:54.472Z","repository":{"id":308378311,"uuid":"1032586644","full_name":"milisp/plux","owner":"milisp","description":"💡AI finder/explorer. One click @files via a visual filetree and save insights in a notepad. build with Tauri","archived":false,"fork":false,"pushed_at":"2025-10-25T15:12:11.000Z","size":2558,"stargazers_count":17,"open_issues_count":0,"forks_count":2,"subscribers_count":0,"default_branch":"dev","last_synced_at":"2025-10-25T17:19:04.794Z","etag":null,"topics":["chatgpt","claude","dxt","explorer","finder","gemini","gpt-oss","llm-inference","mcp","mcp-client","ollama","openrouter"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/milisp.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-08-05T14:19:08.000Z","updated_at":"2025-10-25T15:12:15.000Z","dependencies_parsed_at":"2025-08-05T17:19:56.218Z","dependency_job_id":"425fb321-06c4-48e5-a4f6-b9a19b5a2e71","html_url":"https://github.com/milisp/plux","commit_stats":null,"previous_names":["milisp/plux"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/milisp/plux","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/milisp%2Fplux","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/milisp%2Fplux/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/milisp%2Fplux/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/milisp%2Fplux/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/milisp","download_url":"https://codeload.github.com/milisp/plux/tar.gz/refs/heads/dev","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/milisp%2Fplux/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32043039,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-20T00:18:06.643Z","status":"online","status_checked_at":"2026-04-20T02:00:06.527Z","response_time":94,"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":["chatgpt","claude","dxt","explorer","finder","gemini","gpt-oss","llm-inference","mcp","mcp-client","ollama","openrouter"],"created_at":"2025-08-06T02:01:42.786Z","updated_at":"2026-04-20T10:32:54.454Z","avatar_url":"https://github.com/milisp.png","language":"TypeScript","readme":"# Plux: The End of Copy-Paste AI Workflows\n\n\u003e **AI + Filetree + plus button + notepad** — One-click your files to AI. Built-in magic notepad saves insights.\n\n\u003cdiv align=\"center\"\u003e\n\n### 🎯 **See a file? Click `+`. That's it. No more copy-paste hell.**\n\n[![GitHub Stars](https://img.shields.io/github/stars/milisp/plux?style=for-the-badge\u0026logo=github\u0026color=gold)](https://github.com/milisp/plux/stargazers)\n[![Downloads](https://img.shields.io/github/downloads/milisp/plux/total?style=for-the-badge\u0026color=blue)](https://github.com/milisp/plux/releases)\n[![License](https://img.shields.io/github/license/milisp/plux?style=for-the-badge\u0026color=green)](LICENSE)\n\n**Finally, an AI tool that gets file management right.**\n\n*Built for developers, researchers, writers, and anyone tired of copy-pasting files into AI chats.*\n\n[🚀 **Download Now**](https://github.com/milisp/plux/releases) • [📖 **Documentation**](./docs) • [💬 **Community**](https://github.com/milisp/plux/discussions) • [⭐ **Star Us**](https://github.com/milisp/plux/stargazers)\n\n\u003c/div\u003e\n\n---\n\n## 🛠 Technical Overview\n\n**Tech Stack**: React + TypeScript + Tauri + Model Context Protocol (MCP)\n\n**Supported AI Providers**: OpenRouter, Claude, GPT, Gemini, Ollama\n\n**Supported File Types**: PDF, CSV, code files, Markdown, plain text, and more\n\n**MCP Server Options**:\n- Rust: `rust-mcp-filesystem`\n- Node.js: `@modelcontextprotocol/server-filesystem`\n\n**Performance**: Native Tauri app (~6MB) with instant file tree navigation and syntax-highlighted preview\n\n---\n\n## The Problem We All Face\n\n```\n😤 Find file → Open file → Select all → Copy → Switch to AI → Paste → Repeat...\n```\n\n**Sound familiar?** We've all been there. Until now.\n\n## The Plux Solution\n\n```\n😎 See file → Click + → Ask AI → Done.\n```\n\n**Plux** transforms your local files—PDFs, code, CSVs, documents, anything—into AI context with **one click**. No more copy-paste workflows. No more lost context. Just pure, visual file management for the AI age.\n\n## 🔍 How Plux Compares\n\n- **Cursor IDE**: Relies on typing `@` + filename inside an IDE. Limited to specific IDE environments and requires more typing.  \n- **Claude Code**: Works in the terminal with commands; requires familiarity with file paths and less visual feedback.  \n- **Plux**: Visual file tree + one-click `+` button + works with any AI model + native desktop experience.\n\n[📖 Full comparison here](./docs/plux-positioning-and-comparison.md)\n\n## 🖼️ See It In Action\n\n![Plux Interface](images/plux.png)\n\n\u003cdiv align=\"center\"\u003e\n\u003cem\u003eThe visual file tree with the magical + button. One click adds any file to your AI conversation.\u003c/em\u003e\n\u003c/div\u003e\n\n---\n\n## ✨ Why Developers Love Plux\n\n### 🚀 **Instant Context, Zero Friction**\n```\n📁 Your Project/\n├── 📄 main.py          [+] ← Click to add\n├── 📁 components/      [+] ← Add entire folder  \n│   ├── 📄 header.tsx   [+]\n│   └── 📄 footer.tsx   [+]\n└── 📄 README.md        [+]\n```\n\n### 💪 **Everything You Need, Nothing You Don't**\n- ➕ **One-Click Context**: The + button that changes everything\n- 🔍 **Smart File Explorer**: Browse and preview files instantly\n- 💬 **Multi-Model AI**: Claude, GPT, Gemini, Ollama — all in one place\n- 📊 **Universal File Support**: PDFs, CSVs, code, markdown, anything\n- 🎨 **Beautiful Code Viewer**: Syntax highlighting that doesn't hurt your eyes\n- 📝 **Built-in Notepad**: Save insights without switching apps\n- ✏️ **Lightweight Editing**: Make quick changes to text, markdown, and code files without leaving Plux\n- ⚡ **Desktop Speed**: Native Tauri performance (~6MB)\n- 🔒 **Privacy First**: Your files never leave your machine\n\n---\n\n## 🎯 Real-World Magic\n\n### For Developers 👨‍💻\n```bash\n# Instead of this painful workflow:\ncat src/auth.js | pbcopy\n# paste into AI chat\ncat src/components/Login.tsx | pbcopy  \n# paste again...\n\n# Do this:\n# Click + on auth.js\n# Click + on Login.tsx\n# Ask AI anything\n```\n\n### For Researchers 📚\n- **Literature Review**: Add papers, notes, datasets with visual confirmation\n- **Data Analysis**: Include methodology files, results, previous findings\n- **Thesis Writing**: Organize chapters and references effortlessly\n\n### For Content Creators ✍️\n- **Blog Writing**: Research materials, drafts, references — all at your fingertips\n- **Documentation**: Code files to comprehensive docs in seconds\n- **Creative Projects**: Inspiration, drafts, and ideas organized visually\n\n---\n\n## ⚡ Quick Start Examples\n\n### Example 1: Code Review\n```\n1. Browse to your feature branch files\n2. Click + on the files you changed  \n3. Ask: \"Review this implementation for security issues\"\n4. Get instant, contextual feedback\n```\n\n### Example 2: Data Analysis  \n```\n1. Click + on your dataset.csv\n2. Click + on analysis_config.json\n3. Ask: \"What patterns do you see in this data?\"\n4. Save insights to built-in notepad\n```\n\n### Example 3: Debug Complex Issue\n```\n1. Add error logs with +\n2. Add related source files with +\n3. Add configuration files with +\n4. Ask: \"What's causing this bug?\"\n```\n\n**No copy-paste. No file hunting. Just pure, visual context management.**\n\n## 🚀 Get Started in 60 Seconds\n\n### 📥 Installation\n\n**🎉 Coming Soon: One-Click Downloads**\n- 🍎 **macOS**: Download `.dmg` \n- 🪟 **Windows**: Download `.exe`\n- 🐧 **Linux**: Download `.AppImage`\n\n**📦 Build from Source**\n\n### Prerequisites\n\n[development or CONTRIBUTING](CONTRIBUTING.md)\n\n```bash\ngit clone https://github.com/milisp/plux.git\ncd plux\nbun install\nbun tauri build\n```\n\n### ⚙️ Quick Setup\n\n1. **🗂️ Install filesystem MCP server** (handles file operations):\n```bash\n# Option 1: Rust version (recommended)\ncargo install rust-mcp-filesystem\n```\n\nor download [rust-mcp-filesystem](https://rust-mcp-stack.github.io/rust-mcp-filesystem/#/guide/install)\n\n\n2. **📝 Create config file** at `~/.config/plux/mcp.json`:\n```json\n{\n  \"mcpServers\": {\n    \"filesystem\": {\n      \"command\": \"rust-mcp-filesystem\",\n      \"args\": [\"~/\"]\n    }\n  }\n}\n```\n\n#### Option 2: Node.js version  \n\n```json\n{\n  \"mcpServers\": {\n    \"filesystem\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"-y\",\n        \"@modelcontextprotocol/server-filesystem\",\n        \"~/\"\n      ]\n    }\n  }\n}\n```\n\n3. **🚀 Launch Plux** and start clicking those + buttons!\n\n### 🎯 First Steps\n1. **Browse Files**: Explore your project in the visual tree\n2. **Click +**: Add files to your AI conversation  \n3. **Ask Questions**: Chat with AI about your code/documents\n4. **Save Insights**: Use the built-in notepad for important findings\n\n**That's it! Welcome to the future of AI file management.**\n\n---\n\n## 🗺️ What's Coming Next\n\n\u003cdiv align=\"center\"\u003e\n\n### 🚀 **Join 1000+ developers building the future of AI workflows**\n\n\u003c/div\u003e\n\n**🔥 Active Development Roadmap:**\n- [x] ✅ Multi-model support (Claude, GPT, Gemini, Ollama)\n- [x] ✅ Visual file tree with + button magic\n- [x] ✅ Built-in notepad system\n- [ ] 🚧 **Smart context suggestions** - \"You might also want these files\"\n- [ ] ⚙️ Auto-download and path setup for rust-mcp-filesystem\n- [ ] ✏️ **Lightweight editor** - Inline editing for quick changes without switching tools\n- [ ] 📊 Model comparison view\n- [ ] 📱 **Mobile companion app** - Access your notes anywhere  \n- [ ] 🧠 **Context memory** - Remember file combinations across sessions\n- [ ] 🔗 **File relationship mapping** - Visual connections between related files\n- [ ] 🎨 **Custom themes** - Make Plux match your style\n- [ ] 🚀 **Auto-setup wizard** - Zero-config MCP server installation\n- [ ] 🔌 **Plugin ecosystem** - Community-built file type support\n- [ ] 🤖 Mutil steps agent\n\n---\n\n## 🤝 Join the Revolution\n\n\u003cdiv align=\"center\"\u003e\n\n**Plux is more than a tool — it's a movement to end copy-paste workflows forever.**\n\n### Ready to be part of the change?\n\n[![Star on GitHub](https://img.shields.io/github/stars/milisp/plux?style=for-the-badge\u0026logo=github\u0026label=Star%20on%20GitHub\u0026color=gold)](https://github.com/milisp/plux/stargazers)\n[![Follow Updates](https://img.shields.io/github/watchers/milisp/plux?style=for-the-badge\u0026logo=github\u0026label=Watch\u0026color=blue)](https://github.com/milisp/plux/watchers)\n[![Join Discord](https://img.shields.io/badge/Discord-Join%20Community-5865F2?style=for-the-badge\u0026logo=discord)](https://discord.gg/plux)\n\n**🌟 Star us** • **🍴 Fork it** • **🐛 Report bugs** • **💡 Suggest features** • **📢 Spread the word**\n\n\u003c/div\u003e\n\n### 🙌 How to Contribute\n\n- 🌟 **Star this repo** - Show your support!\n- 🐛 **Report issues** - Help us improve\n- 💡 **Share ideas** - What features do you need?\n- 📢 **Tell others** - Tweet, blog, or just tell a friend\n- 🔧 **Build plugins** - Extend Plux for your use case\n- 💻 **Code contributions** - Check out our [Contributing Guide](CONTRIBUTING.md)\n\n### 🎯 Our Mission\n\n**To make AI context management so intuitive that the + button becomes as fundamental as copy-paste.**\n\nEvery file tree should have + buttons. Every AI tool should respect visual workflows. Every developer should spend time building, not managing context.\n\n**Join us. Let's kill copy-paste forever.**\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n### 📚 Learn More\n\n[📖 **Documentation**](./docs) • [🎥 **Demo Video**](./docs/demo.md) • [🔧 **API Reference**](./docs/api.md) • [🤔 **FAQ**](./docs/faq.md)\n\n**Built with ❤️ by developers who were tired of copy-paste workflows**\n\n*The revolution starts with a single +*\n\n\u003c/div\u003e\n","funding_links":[],"categories":["🙏 Acknowledgments","Community","📚 Projects (2474 total)"],"sub_categories":["Areas for Contribution","Community Projects","MCP Servers"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmilisp%2Fplux","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmilisp%2Fplux","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmilisp%2Fplux/lists"}