@pheem49/mint 1.4.0 → 1.4.2

package/README.md

@@ -1,200 +1,153 @@
 # Mint
 
 <p align="center">
-  <img src="assets/icon.png" alt="Luna Mint Icon" width="160">
+  <img src="assets/icon.png" alt="Mint Icon" width="160">
 </p>
 
 <p align="center">
-  <strong>An advanced AI Assistant built for the modern workflow — now on Desktop & Terminal.</strong>
+  <strong>The Unified AI Desktop Assistant & Agentic Coding CLI. Built for speed, power, and local control.</strong>
 </p>
 
 <p align="center">
   <img src="https://img.shields.io/badge/License-AGPL--3.0-blue?style=for-the-badge" alt="License">
   <img src="https://img.shields.io/badge/Node.js-LTS-green?style=for-the-badge&logo=node.js" alt="Node.js">
-  <img src="https://img.shields.io/badge/Electron-Latest-47848F?style=for-the-badge&logo=electron" alt="Electron">
-  <img src="https://img.shields.io/badge/Powered%20By-Gemini-orange?style=for-the-badge&logo=google-gemini" alt="Gemini">
+  <img src="https://img.shields.io/badge/Electron-40.x-47848F?style=for-the-badge&logo=electron" alt="Electron">
+  <img src="https://img.shields.io/badge/CLI-Unified_Agent-orange?style=for-the-badge" alt="CLI Agentic">
 </p>
 
----
+Mint is an advanced AI assistant designed to live in your workspace. It features a rich Electron desktop interface for day-to-day assistance and a powerful, unified CLI agent that seamlessly merges conversational chat with complex coding tasks.
 
-**Mint** is a powerful AI Assistant built with **Electron**, **Node.js**, and **Google Gemini** (with extended support for Hugging Face, Anthropic, OpenAI, and Local Models). It bridges the gap between your Desktop and Terminal, featuring real-time screen vision, web automation, local knowledge search, and a professional CLI for developers who love the command line.
-
-## Highlights
-
-- **Dual-Mode AI**: Switch between a beautiful **Desktop GUI** and a professional **CLI**.
-- **Code Agent Mode**: Use `mint code "<task>"` to inspect, edit, and verify a project directly from the current terminal workspace.
-- **Chat-First Workflow**: Regular Mint chat can now auto-route coding requests into workspace Code Mode, so the main chat acts as the control surface.
-- **Advanced Multi-Agent Hub**: 
-  - **Smart Routing**: Intelligently routes coding/general tasks to the most capable configured provider (e.g., Claude, OpenAI, Gemini).
-  - **Agent Collaboration**: Enable Multi-Agent Review so that a primary AI writes the code while a secondary AI automatically reviews it in the same loop.
-  - **Resilient Fallback**: Automatically fallbacks to alternative AI providers (Gemini, Anthropic, OpenAI, Hugging Face, LM Studio, Ollama) if your active provider fails.
-- **Visible Mode State**: The CLI status bar now shows whether Mint is currently in `Chat` or `Code` mode.
-- **Interactive Slash Commands**: Manage models and settings in the terminal with `/model`, `/config`, `/clear`, etc.
-- **Smart TUI Experience**: Professional message framing, character-wrapped Thai text support, and mouse scroll wheel navigation.
-- **System Information Action**: Retrieve OS, Kernel, and Architecture details via natural language.
-- **Dynamic UI Aesthetics**: Animated **Aura Glow** for the AI widget and **Glassmorphism** design.
-- **Minimize-to-Tray**: Keep Mint running in the background via the System Tray.
-- **Vision-Ready (Desktop)**: Capture, analyze, and translate any part of your screen in real-time.
-- **Automation First**: Control your system and browser via natural language from both App and Terminal.
-- **Background Agent**: Install Mint as a `systemd` user service for proactive monitoring.
+## 🌟 What's New in v1.4.1
 
----
+- **Unified Agent Loop:** No more switching modes. Every interaction in the CLI is now handled by a sophisticated agent that can think, plan, and execute tools autonomously.
+- **Agentic Web Search:** Mint can now search the internet in real-time to answer questions with the latest information using integrated web tools.
+- **Upgraded TUI:** A redesigned terminal interface featuring a Braille spinner, thinking timer, and a cleaner "✓ ActionName" logging style.
+- **Interactive "Ask User":** The agent can now pause and ask you for clarification or preferences during complex multi-step tasks.
+- **Enhanced System Control:** Reliable multi-fallback support for opening files, folders, and applications on Linux (Pop!_OS/Ubuntu), macOS, and Windows.
 
-## Screenshots
+## 🚀 Key Features
 
-<p align="center">
-  <img src="assets/Agent_Mint.png" alt="Agent Mint UI" width="48%">
-  <img src="assets/Settings.png" alt="Settings Window" width="48%">
-</p>
-<p align="center">
-  <em>Desktop Interface and personalized Settings window</em>
-</p>
+### 💻 Unified CLI Agent
+Mint CLI is not just a chat wrapper; it's a full agentic workflow.
+- **Think & Plan:** Every response starts with a reasoning phase where Mint plans its next move.
+- **Autonomous Tools:** `web_search`, `list_files`, `read_file`, `search_code`, `run_shell`, `apply_patch`, `write_file`, `open_folder`, and more.
+- **User-in-the-Loop:** Safety first. Mint asks for your approval before running shell commands or making file edits.
+- **Workspace Aware:** Automatically understands your project structure, git status, and testing framework.
 
----
+### 🖥️ Desktop Assistant
+- **Screen Vision:** Capture and analyze your screen for instant help with what you're looking at.
+- **Real-time Translation:** Instantly translate text from your screen into Thai or English.
+- **Proactive Engine:** Mint monitors your system events to provide helpful suggestions before you even ask.
+- **System Tray & Floating Widgets:** Quick access to Mint from anywhere on your desktop.
 
-## CLI Usage (Power Users)
+### 🛠️ Multi-Provider Support
+Mint supports the latest LLMs and local backends:
+- **Cloud:** Gemini 1.5/2.0 Pro & Flash, Anthropic Claude 3.5, OpenAI GPT-4o.
+- **Local:** Ollama, LM Studio, Hugging Face Inference API.
+- **MCP:** Full support for Model Context Protocol to extend Mint's capabilities with external tools.
 
-Mint CLI is built for speed and efficiency. Use the **`mint`** command from anywhere.
+## 📸 Screenshots
 
 <p align="center">
-  <img src="assets/CLI_Screen.png" alt="Mint CLI Preview" width="100%">
+  <img src="assets/Agent_Mint.png" alt="Mint Desktop UI" width="48%">
+  <img src="assets/Settings.png" alt="Mint Settings" width="48%">
 </p>
 
-### Professional Commands
-- **`mint`** : Start interactive chat mode (Default).
-- **`mint code "task"`** : Run Mint as a workspace-aware coding agent in the current project folder.
-- **`mint agent`** : Run Mint as a headless background agent (Monitoring mode).
-- **`mint agent "task"`** : Start agent and execute an autonomous task immediately.
-- **`mint task "task"`** : Delegate a multi-step task to an already running background agent.
-- **`mint onboard`** : Setup API Key, Model, and initialize global configuration in `~/.mint/`.
-- **`mint list`** : See full list of automation actions and plugins.
-
----
-
-### Autonomous Agent (Task Delegate)
-Mint isn't just a chatbot—it's an autonomous worker. Assign complex tasks that require multiple steps of reasoning.
-
-### Code Agent Mode
-Mint now includes a dedicated coding workflow as the first step toward a Claude-Code-like experience in the terminal.
-
-**What it can do now:**
-- Inspect the current workspace before editing
-- Search code across the repo
-- Read targeted file ranges
-- Run non-destructive shell commands in the project with interactive approval
-- Apply patch-based file edits with approval before changes are written
-- Reuse lightweight session memory and git/test context per project
+<p align="center">
+  <img src="assets/CLI_Screen.png" alt="Mint CLI" width="100%">
+</p>
 
-**Usage Example:**
-```bash
-mint code "fix the failing CLI command and verify it"
-```
+## 📦 Installation
 
-**Chat-first Example:**
+### Global Install
 ```bash
-mint
-> สำรวจโปรเจคนี้ให้หน่อย
+npm install -g @pheem49/mint@latest
 ```
 
-Mint will classify the request, switch the status bar to `Code`, and return to `Chat` mode after the coding flow finishes.
-
-**Supported Autonomous Tools:**
-- **Web Automation**: Full Puppeteer-based browsing, info extraction, and research.
-- **File System**: Create, Write, Delete, and Manage folders using `~/` path expansion.
-- **Knowledge Search**: Query local files and documentation (RAG).
-- **Safety Mode (Bash)**: Mint proposes commands via notifications; you choose whether to run them.
-
-**Usage Examples:**
+### Local Development
 ```bash
-# Research and write a report
-mint agent 'Search for the latest iPhone reviews and write a SUMMARY.md to my desktop.'
-
-# Background Task
-mint task 'Process these 5 files and move them to ~/Documents/Archive'
+git clone https://github.com/Pheem49/Mint.git
+cd Mint
+npm install
 ```
 
----
-
-### Slash Commands (Interactive Chat)
-While in terminal chat, type **`/`** to access advanced tools with the new visual autocomplete system.
-> [!TIP]
-> Use **Up/Down arrow keys** to navigate the suggestion list and press **Enter** to select!
-
-- `/help` : View all commands and descriptions.
-- `/models` : List and switch between Gemini, Ollama, Hugging Face, Anthropic, OpenAI, and Local models.
-- `/config` : Check your active API keys and preferences.
-- `/clear` / `/reset` : Clean terminal or reset AI context.
-
----
-
-### Proactive Monitoring
-When running in `agent` mode, Mint monitors your system in the background:
-- **Battery Alerts**: Notifies you when power is low or charging status changes.
-- **Network Status**: Alerts you when connection status changes.
-- **Resource Usage**: Proactive tips if system load is too high (System Metrics).
-
+## ⚡ Quick Start
 
----
-
-## Desktop GUI Features
+1. **Setup Mint:**
+   ```bash
+   mint onboard
+   ```
+2. **Start Chatting:**
+   ```bash
+   mint
+   ```
+3. **Run the Desktop App:**
+   ```bash
+   npm start
+   ```
 
-- **Floating Widget**: A persistent AI character on your desktop.
-- **Animated Aura**: The widget breathes and glows when Mint is thinking or proactive.
-- **Minimize to Tray**: Click the dash icon (-) to hide the window to your system tray. Mint stays active!
-- **Widget Toggle**: Enable or disable the desktop widget anytime from **Settings > General**.
-- **Screen Overlay Glow**: Visual feedback when Mint is capturing your screen for analysis.
+## ⌨️ CLI Commands
 
----
+- `mint` / `mint chat` : Start the unified interactive agent UI.
+- `mint code "<task>"` : Run a specific coding task in the current workspace.
+- `mint task "<task>"` : Queue a background task for the headless agent.
+- `mint mcp` : Manage Model Context Protocol (MCP) servers.
+- `mint list` : Display all available features and commands.
 
-## Security & Privacy
+## 🔌 MCP Management (Extensions)
 
-- **Push Protection**: Automated `.gitignore` patterns for `mint-config.json` and `.env` files.
-- **History Scrubbing**: Integrated tools to ensure API keys are never leaked to Git history.
-- **Local First**: Built-in **Ollama** and **LM Studio (OpenAI Compatible)** support for 100% private, offline AI processing.
+Mint supports the **Model Context Protocol (MCP)**, allowing you to extend its capabilities via the CLI without manual config editing.
 
----
+### Add a New Server
+```bash
+# Template
+mint mcp add <name> <command> --args <args...> --env <KEY=VALUE>
 
-## Getting Started
+# Example: Google Search
+mint mcp add google-search npx --args -y @modelcontextprotocol/server-google-search --env GOOGLE_API_KEY=your_key GOOGLE_SEARCH_ENGINE_ID=your_id
 
-### Prerequisites
-- [Node.js](https://nodejs.org/) (LTS)
-- [npm](https://www.npmjs.com/)
-- A **Google Gemini API Key** (Get one at [Google AI Studio](https://aistudio.google.com/))
+# Example: Filesystem Access
+mint mcp add my-files npx --args -y @modelcontextprotocol/server-filesystem /path/to/folder
+```
 
-### Installation
-1. **Install via NPM (Recommended)**
-   ```bash
-   npm install -g @pheem49/mint@latest
-   ```
+### List Configured Servers
+```bash
+mint mcp list
+```
 
-2. **Manual Installation (For Developers)**
-   ```bash
-   git clone https://github.com/Pheem49/Mint.git
-   cd Mint
-   npm install
-   sudo npm link
-   ```
+### Remove a Server
+```bash
+mint mcp remove google-search
+```
 
----
+### Clear All Servers
+```bash
+mint mcp clear
+```
 
-## Project Structure
+## 🏗️ Project Structure
 
 ```text
 Mint/
 ├── src/
-│   ├── AI_Brain/        # Gemini/Ollama integration & logic
-│   ├── Automation/      # Puppeteer and browser scripts
-│   ├── CLI/             # CLI Onboarding and Feature list
-│   ├── Plugins/         # Spotify, Docker, Obsidian, Git, etc.
-│   ├── System/          # Config, Daemon, and Event Monitoring
-│   └── UI/              # Electron renderer (Glassmorphism & Aura)
-├── mint-cli.js          # CLI Main Entry
-├── main.js              # Electron Main process
-└── package.json         # Binaries and dependencies
+│   ├── AI_Brain/          # Gemini API, Unified Agent Client, Memory Store
+│   ├── Automation_Layer/  # File Ops, Browser Automation, System Control
+│   ├── CLI/               # TUI logic, Chat Router, Code Agent
+│   ├── Plugins/           # MCP Manager, System Monitor, Third-party integrations
+│   ├── System/            # Config, Notifications, Daemons
+│   └── UI/                # Electron Renderer, Settings, Widgets
+├── mint-cli.js            # Main CLI entry point
+└── package.json
 ```
 
----
+## 🛡️ Security & Privacy
+- **Local Control:** Mint prioritizes local execution and user privacy.
+- **Approval System:** No destructive command or file change happens without your explicit `y/n` confirmation.
+- **Secure Config:** API keys are stored locally on your machine and never transmitted outside of the chosen AI provider.
 
-## License
+## 📜 License
+Mint is licensed under the **GNU Affero General Public License v3.0**.
+See the [LICENSE](LICENSE) file for more details.
 
-Distributed under the **GNU Affero General Public License v3.0**. See `LICENSE` for details.
+---
+<p align="center">Made with 💚 by <a href="https://github.com/Pheem49">Pheem49</a></p>

package/main.js

@@ -6,7 +6,7 @@ const { handleChat, resetChat, getChatTranscript, translateImageContent, refresh
 const { openApp } = require('./src/Automation_Layer/open_app');
 const { openWebsite, openSearch } = require('./src/Automation_Layer/open_website');
 const { performWebAutomation } = require('./src/Automation_Layer/browser_automation');
-const { createFolder, openFile, deleteFile } = require('./src/Automation_Layer/file_operations');
+const { createFolder, openFile, deleteFile, findPath } = require('./src/Automation_Layer/file_operations');
 const { getSystemInfo, getWeather } = require('./src/System/system_info');
 const { readConfig, writeConfig } = require('./src/System/config_manager');
 const { parseCommand } = require('./src/Command_Parser/parser');
@@ -868,6 +868,26 @@ async function executeAction(action) {
         case 'delete_file':
             await deleteFile(action.target);
             break;
+        case 'find_path': {
+            const result = findPath(action.target, {
+                type: action.pathType,
+                maxResults: 10
+            });
+            if (!result.success) {
+                return result.message;
+            }
+
+            if (action.openAfter === true) {
+                if (result.matches.length === 1) {
+                    const match = result.matches[0];
+                    const openResult = await openFile(match.path);
+                    return openResult || `Successfully found and opened ${match.type === 'dir' ? 'folder' : 'file'}: ${match.path} ✅`;
+                }
+                return `Found multiple matches for "${action.target}". Please be more specific:\n${result.matches.map(m => `- [${m.type}] ${m.path}`).join('\n')}`;
+            }
+
+            return `Found matches for "${action.target}":\n${result.matches.map(m => `- [${m.type}] ${m.path}`).join('\n')}`;
+        }
         case 'clipboard_write':
             clipboard.writeText(action.target);
             break;

package/mint-cli-logic.js

@@ -1,10 +1,7 @@
 // Mint CLI Action Logic
 const { openApp } = require('./src/Automation_Layer/open_app');
 const { openWebsite, openSearch } = require('./src/Automation_Layer/open_website');
-const { createFolder, openFile, deleteFile } = require('./src/Automation_Layer/file_operations');
-const { indexFile } = require('./src/AI_Brain/knowledge_base');
-const SystemAutomation = require('./src/System/system_automation');
-const pluginManager = require('./src/Plugins/plugin_manager');
+const { createFolder, openFile, deleteFile, findPath } = require('./src/Automation_Layer/file_operations');
 
 async function executeAction(action) {
     if (!action || action.type === 'none') return null;
@@ -24,14 +21,32 @@ async function executeAction(action) {
                 createFolder(action.target);
                 return `Created folder: ${action.target}`;
             case 'open_file':
-                await openFile(action.target);
-                return `Opening: ${action.target}`;
             case 'open_folder':
-                await openFile(action.target);
-                return `Opening folder: ${action.target}`;
+                const res = await openFile(action.target);
+                return res === true ? `Opening: ${action.target}` : res;
             case 'delete_file':
                 await deleteFile(action.target);
                 return `Deleted: ${action.target}`;
+            case 'find_path': {
+                const result = findPath(action.target, {
+                    type: action.pathType,
+                    maxResults: 10
+                });
+                if (!result.success) {
+                    return result.message;
+                }
+
+                if (action.openAfter === true) {
+                    if (result.matches.length === 1) {
+                        const match = result.matches[0];
+                        await openFile(match.path);
+                        return `Found and opened ${match.type === 'dir' ? 'folder' : 'file'}: ${match.path}`;
+                    }
+                    return `Found multiple matches for "${action.target}". Please be more specific:\n${result.matches.map(m => `- [${m.type}] ${m.path}`).join('\n')}`;
+                }
+
+                return `Found matches for "${action.target}":\n${result.matches.map(m => `- [${m.type}] ${m.path}`).join('\n')}`;
+            }
             case 'learn_file':
                 return await indexFile(action.target);
             case 'mcp_tool':