Skip to content

milisp/plux

Repository files navigation

Plux: The End of Copy-Paste AI Workflows

File tree + plus button β€” One-click your files to AI.
Your personal AI finder/explorer.

🎯 See a file? Click +. That's it. No more copy-paste hell.

GitHub Stars Downloads License

Finally, an AI tool that gets file management right.

Built for developers, researchers, writers, and anyone tired of copy-pasting files into AI chats.

πŸš€ Download Now β€’ πŸ“– Documentation β€’ πŸ’¬ Community β€’ ⭐ Star Us


πŸ›  Technical Overview

Tech Stack: React + TypeScript + Tauri + Model Context Protocol (MCP)

Supported AI Providers: OpenRouter, Claude, GPT, Gemini, Ollama

Supported File Types: PDF, CSV, code files, Markdown, plain text, and more

MCP Server Options:

  • Rust: cargo install rust-mcp-filesystem
  • Node.js: npm install -g @modelcontextprotocol/server-filesystem

Performance: Native Tauri app (~6MB) with instant file tree navigation and syntax-highlighted preview


The Problem We All Face

😀 Find file β†’ Open file β†’ Select all β†’ Copy β†’ Switch to AI β†’ Paste β†’ Repeat...

Sound familiar? We've all been there. Until now.

The Plux Solution

😎 See file β†’ Click + β†’ Ask AI β†’ Done.

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.

πŸ” How Plux Compares

  • Cursor IDE: Relies on typing @ + filename inside an IDE. Limited to specific IDE environments and requires more typing.
  • Claude Code: Works in the terminal with commands; requires familiarity with file paths and less visual feedback.
  • Plux: Visual file tree + one-click + button + works with any AI model + native desktop experience.

πŸ“– Full comparison here

πŸ–ΌοΈ See It In Action

Plux Interface

The visual file tree with the magical + button. One click adds any file to your AI conversation.

✨ Why Developers Love Plux

πŸš€ Instant Context, Zero Friction

πŸ“ Your Project/
β”œβ”€β”€ πŸ“„ main.py          [+] ← Click to add
β”œβ”€β”€ πŸ“ components/      [+] ← Add entire folder  
β”‚   β”œβ”€β”€ πŸ“„ header.tsx   [+]
β”‚   └── πŸ“„ footer.tsx   [+]
└── πŸ“„ README.md        [+]

πŸ’ͺ Everything You Need, Nothing You Don't

  • βž• One-Click Context: The + button that changes everything
  • πŸ” Smart File Explorer: Browse and preview files instantly
  • πŸ’¬ Multi-Model AI: Claude, GPT, Gemini, Ollama β€” all in one place
  • πŸ“Š Universal File Support: PDFs, CSVs, code, markdown, anything
  • 🎨 Beautiful Code Viewer: Syntax highlighting that doesn't hurt your eyes
  • πŸ“ Built-in Notepad: Save insights without switching apps
  • ⚑ Desktop Speed: Native Tauri performance (~6MB)
  • πŸ”’ Privacy First: Your files never leave your machine

🎯 Real-World Magic

For Developers πŸ‘¨β€πŸ’»

# Instead of this painful workflow:
cat src/auth.js | pbcopy
# paste into AI chat
cat src/components/Login.tsx | pbcopy  
# paste again...

# Do this:
# Click + on auth.js
# Click + on Login.tsx
# Ask AI anything

For Researchers πŸ“š

  • Literature Review: Add papers, notes, datasets with visual confirmation
  • Data Analysis: Include methodology files, results, previous findings
  • Thesis Writing: Organize chapters and references effortlessly

For Content Creators ✍️

  • Blog Writing: Research materials, drafts, references β€” all at your fingertips
  • Documentation: Code files to comprehensive docs in seconds
  • Creative Projects: Inspiration, drafts, and ideas organized visually

⚑ Quick Start Examples

Example 1: Code Review

1. Browse to your feature branch files
2. Click + on the files you changed  
3. Ask: "Review this implementation for security issues"
4. Get instant, contextual feedback

Example 2: Data Analysis

1. Click + on your dataset.csv
2. Click + on analysis_config.json
3. Ask: "What patterns do you see in this data?"
4. Save insights to built-in notepad

Example 3: Debug Complex Issue

1. Add error logs with +
2. Add related source files with +
3. Add configuration files with +
4. Ask: "What's causing this bug?"

No copy-paste. No file hunting. Just pure, visual context management.

πŸš€ Get Started in 60 Seconds

πŸ“₯ Installation

πŸŽ‰ Coming Soon: One-Click Downloads

  • 🍎 macOS: Download .dmg
  • πŸͺŸ Windows: Download .exe
  • 🐧 Linux: Download .AppImage

πŸ“¦ Build from Source

Prerequisites

development or CONTRIBUTING

git clone https://github.com/milisp/plux.git
cd plux
bun install
bun tauri build

βš™οΈ Quick Setup

  1. πŸ—‚οΈ Install filesystem MCP server (handles file operations):
# Option 1: Rust version (recommended)
cargo install rust-mcp-filesystem

or download rust-mcp-filesystem

  1. πŸ“ Create config file at ~/.config/plux/mcp.json:
{
  "mcpServers": {
    "filesystem": {
      "command": "rust-mcp-filesystem",
      "args": ["~/"]
    }
  }
}

Option 2: Node.js version

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "~/"
      ]
    }
  }
}
  1. πŸš€ Launch Plux and start clicking those + buttons!

🎯 First Steps

  1. Browse Files: Explore your project in the visual tree
  2. Click +: Add files to your AI conversation
  3. Ask Questions: Chat with AI about your code/documents
  4. Save Insights: Use the built-in notepad for important findings

That's it! Welcome to the future of AI file management.


πŸ—ΊοΈ What's Coming Next

πŸš€ Join 1000+ developers building the future of AI workflows

πŸ”₯ Active Development Roadmap:

  • βœ… Multi-model support (Claude, GPT, Gemini, Ollama)
  • βœ… Visual file tree with + button magic
  • βœ… Built-in notepad system
  • 🚧 Smart context suggestions - "You might also want these files"
  • βš™οΈ Auto-download and path setup for rust-mcp-filesystem
  • πŸ“Š Model comparison view
  • πŸ“± Mobile companion app - Access your notes anywhere
  • 🧠 Context memory - Remember file combinations across sessions
  • πŸ”— File relationship mapping - Visual connections between related files
  • 🎨 Custom themes - Make Plux match your style
  • πŸš€ Auto-setup wizard - Zero-config MCP server installation
  • πŸ”Œ Plugin ecosystem - Community-built file type support

🀝 Join the Revolution

Plux is more than a tool β€” it's a movement to end copy-paste workflows forever.

Ready to be part of the change?

Star on GitHub Follow Updates Join Discord

🌟 Star us β€’ 🍴 Fork it β€’ πŸ› Report bugs β€’ πŸ’‘ Suggest features β€’ πŸ“’ Spread the word

πŸ™Œ How to Contribute

  • 🌟 Star this repo - Show your support!
  • πŸ› Report issues - Help us improve
  • πŸ’‘ Share ideas - What features do you need?
  • πŸ“’ Tell others - Tweet, blog, or just tell a friend
  • πŸ”§ Build plugins - Extend Plux for your use case
  • πŸ’» Code contributions - Check out our Contributing Guide

🎯 Our Mission

To make AI context management so intuitive that the + button becomes as fundamental as copy-paste.

Every file tree should have + buttons. Every AI tool should respect visual workflows. Every developer should spend time building, not managing context.

Join us. Let's kill copy-paste forever.


πŸ“š Learn More

πŸ“– Documentation β€’ πŸŽ₯ Demo Video β€’ πŸ”§ API Reference β€’ πŸ€” FAQ

Built with ❀️ by developers who were tired of copy-paste workflows

The revolution starts with a single +

About

πŸ’‘ File tree + plus button, One-click + your files to AI. AI finder/explorer support gpt-oss

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Contributors 2

  •  
  •