brain-cleaner 1.2.2 → 1.2.4

package/README.es.md

@@ -1,8 +1,13 @@
 # Brain Cleaner
 
+![Brain Cleaner Banner](https://braincleaner.dev/og-image.png)
+
 **Language / Idioma:**
 🇪🇸 Español  |  [🇬🇧 English](https://github.com/konstantinWDK/brain-cleaner/blob/main/README.md)
 
+![Brain Cleaner UI Mockup](https://braincleaner.dev/mockup.png)
+
+---
 [![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)
 [![Licencia: MIT](https://img.shields.io/badge/Licencia-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![Plataforma macOS](https://img.shields.io/badge/plataforma-macOS-lightgrey.svg)](https://www.apple.com/macos/)

package/README.md

@@ -1,5 +1,7 @@
 # Brain Cleaner
 
+![Brain Cleaner Banner](https://braincleaner.dev/og-image.png)
+
 [![NPM Version](https://img.shields.io/npm/v/brain-cleaner.svg)](https://www.npmjs.com/package/brain-cleaner)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![Python 3.9+](https://img.shields.io/badge/python-3.9+-blue.svg)](https://www.python.org/downloads/)
@@ -7,103 +9,79 @@
 **Language / Idioma:**
 🇬🇧 English  |  [🇪🇸 Español](https://github.com/konstantinWDK/brain-cleaner/blob/main/README.es.md)
 
+![Brain Cleaner UI Mockup](https://braincleaner.dev/mockup.png)
+
 ---
 
-**Brain Cleaner** is a professional CLI utility designed to reclaim disk space by identifying and removing digital noise:
-- **AI Residue Cleaner** — Finds cache, logs, and config files from Gemini, Claude, Cursor, Windsurf, and more.
-- **NPM Optimization** — Detects and safely deletes heavy `node_modules` folders from your development projects.
-- **Interactive UI** — High-performance terminal interface with granular selection and safety checks.
+## Why Brain Cleaner?
 
-### ⚙️ Technical Architecture
-While distributed via NPM for ease of use, Brain Cleaner is a hybrid tool. The Node.js wrapper automatically:
-1. Detects your local Python environment.
-2. **Auto-installs missing dependencies** (`blessed`, `Pillow`) on first run.
-3. Seamlessly executes the core Python cleaning engine.
+In the modern development era, our systems are constantly cluttered with "digital noise." Every interaction with AI assistants (Gemini, Claude, Cursor), every NPM project, and every Python experiment leaves behind a trail of logs, cache, and heavy virtual environments that quickly eat up hundreds of gigabytes of disk space.
 
-### 🚀 Recommended Installation (Global)
-Install directly from NPM to get the latest stable version:
+**Brain Cleaner was built to solve this.** It provides a professional, high-performance interface to reclaim your disk space by targeting precisely those development residues that standard cleaners miss.
 
-```bash
-npm install -g brain-cleaner
-```
+---
 
-#### Alternative: Install from Source (Python)
-If you prefer to install via Python/Pip directly from the repository:
+## 🚀 Key Features
 
-```bash
-pip install git+https://github.com/konstantinwdk/brain-cleaner
-```
+- **AI Residue Cleaner** — Deep scan for cache, logs, and configs from Gemini, Claude, Cursor, Windsurf, Trae, and more.
+- **NPM Optimization** — Instantly find and safely delete heavy `node_modules` folders from forgotten projects.
+- **Python Env Manager** — Detect obsolete virtual environments (`venv`, `.venv`) that haven't been touched in over 90 days.
+- **Hybrid Power** — The ease of an NPM global install with the high-performance scanning engine of Python.
+- **Interactive UI** — Choice between a sleek Desktop GUI or a professional Command Line Interface (CLI).
 
-### 🚀 Requirements
-- **Python 3.9+** is required.
-- **Node.js 14+** (if installing via NPM).
+---
 
-## Quick Start
+## ⚙️ Installation
 
-   ```bash
-   cd brain-cleaner
-   ```
-3. **Install the package**:
-   ```bash
-   pip install .
-   ```
+Install globally via NPM to start cleaning immediately:
 
-### Installation (NPM Mode)
-If you are coming from the Node.js ecosystem, you can install it globally via NPM:
 ```bash
 npm install -g brain-cleaner
 ```
-*Note: Requires Python 3.9+ installed on your system.*
-
-## Installation
-
-To install this console interface as a global command:
 
-1. Open your terminal in the root directory of the project.
-2. Run:
-   ```bash
-   pip install .
-   ```
+### Requirements
+- **Python 3.9+** (Required for the scanning engine).
+- **Node.js 14+**.
 
-## Quick Start
+---
 
-Once installed, you can run the interactive interface from anywhere:
+## 📖 How to Use
 
+### 1. Launch the Interface
+Simply run the command from any terminal:
 ```bash
 brain-cleaner
 ```
-*Tip: Use the CLI for fast, keyboard-driven system cleaning.*
 
-> [!IMPORTANT]
-> **macOS 26 (Tahoe) Compatibility**: Use Homebrew Python 3.11 or later to avoid "macOS 26 required" errors in GUI mode.
-> ```bash
-> brew install python@3.11 python-tk@3.11
-> python3.11 -m venv .venv
-> source .venv/bin/activate
-> pip install .
-> ```
+### 2. Choose Your Scope
+Select between scanning your **Home** directory, the **Full System**, or a **Custom Folder** in the sidebar.
 
-## Usage
+### 3. Select Mode & Scan
+- **AI Tools**: For logs and cache from AI assistants.
+- **NPM Modules**: For heavy `node_modules`.
+- **Python Envs**: For identifying abandoned virtual environments.
 
-1. **Scope** — Choose `Home`, `Full System` or `Custom Folder` in the sidebar.
-2. **Mode** — Choose between `AI Tools` or `NPM Modules` to set what to scan.
-3. **Scan** — Click `START SCAN`. Results appear in two labeled sections.
-4. **Review** — Click `›` on any row to expand its subfolders. Check/uncheck individual items.
-5. **Clean** — Use `Clean Selected` for marked items or `Clean All (Visible)` for everything in the active filter.
+### 4. Review & Clean
+Expand entries to review subfolders, check individual items, and click **Clean Selected** or **Clean All**.
 
-> [!WARNING]
-> Deletion is **permanent**. There is no recycle bin. Review carefully before cleaning.
+---
 
-## Detected Categories
+## 🛠 Technical Details
 
-| Category | Tools |
-|---|---|
-| **Gemini** | Google Gemini CLI / API cache |
-| **Claude** | Anthropic Claude logs & config |
-| **IDE Agents** | Cursor, Windsurf, Trae, Roo-Code, Claude-Dev |
-| **Other Tools** | Uncategorized AI tools |
-| **Node Modules** | `node_modules` in Node.js projects |
+While distributed via NPM, Brain Cleaner is a hybrid tool. The Node.js wrapper automatically:
+1. Detects your local Python environment.
+2. Auto-installs core dependencies (`customtkinter`, `blessed`, `Pillow`) on the first run.
+3. Securely executes the cross-platform cleaning engine.
+
+---
+
+## ⚠️ Safety First
+
+> [!WARNING]
+> Deletion is **permanent**. Brain Cleaner does not move files to the trash; it deletes them to reclaim space immediately. Always review the scan results before confirming cleanup.
+
+---
 
-## License
+## 📄 License
 
-MIT — *Developed to keep your system free of digital noise.*
+MIT — *Developed to keep your development system lean and focused.*

package/app.py

@@ -9,6 +9,17 @@ import subprocess
 from scanner import BrainScanner
 from pathlib import Path
 from PIL import Image
+import webbrowser
+
+def resource_path(relative_path):
+    """ Get absolute path to resource, works for dev and for PyInstaller """
+    try:
+        # PyInstaller creates a temp folder and stores path in _MEIPASS
+        base_path = sys._MEIPASS
+    except Exception:
+        base_path = os.path.abspath(".")
+
+    return os.path.join(base_path, relative_path)
 
 ctk.set_appearance_mode("Dark")
 ctk.set_default_color_theme("blue")
@@ -29,8 +40,7 @@ class BrainCleanerApp(ctk.CTk):
         self.current_loc_type = "Home"
 
         # Load Icon
-        assets_dir = os.path.join(os.path.dirname(__file__), "assets")
-        icon_ui_path = os.path.join(assets_dir, "icon_ui.png")
+        icon_ui_path = resource_path(os.path.join("assets", "icon_ui.png"))
         self.logo_image = None
         if os.path.exists(icon_ui_path):
             try:
@@ -42,6 +52,7 @@ class BrainCleanerApp(ctk.CTk):
         # Category definitions
         self.AI_CATS  = ["Gemini", "Claude", "IDE Agents", "Other Tools"]
         self.NPM_CATS = ["Node Modules"]
+        self.PY_CATS  = ["Python Envs", "Python Envs (Obsolete)"]
 
         # Info slider data
         self.info_states = [
@@ -79,7 +90,7 @@ class BrainCleanerApp(ctk.CTk):
         ctk.CTkLabel(title_f, text="Brain Cleaner",
                      font=ctk.CTkFont(size=19, weight="bold")
                      ).pack(pady=(0, 2))
-        ctk.CTkLabel(title_f, text="v1.1.0",
+        ctk.CTkLabel(title_f, text="v1.2.3",
                      font=ctk.CTkFont(size=11, slant="italic"), text_color="#a1a1a1"
                      ).pack()
 
@@ -124,7 +135,14 @@ class BrainCleanerApp(ctk.CTk):
                            font=ctk.CTkFont(size=12), border_color="#2e7d32",
                            hover_color="#2e7d32", fg_color="#2e7d32",
                            command=self._update_mode_ui
-                           ).grid(row=7, column=0, padx=24, pady=(2, 4), sticky="w")
+                           ).grid(row=7, column=0, padx=24, pady=2, sticky="w")
+
+        ctk.CTkRadioButton(self.sidebar, text="Python Envs",
+                           variable=self.scan_mode_var, value="python",
+                           font=ctk.CTkFont(size=12), border_color="#3776ab",
+                           hover_color="#3776ab", fg_color="#3776ab",
+                           command=self._update_mode_ui
+                           ).grid(row=8, column=0, padx=24, pady=(2, 4), sticky="w")
 
         # ── Bottom Sidebar Controls ───────────────────────────────
         bottom = ctk.CTkFrame(self.sidebar, fg_color="transparent")
@@ -294,6 +312,25 @@ class BrainCleanerApp(ctk.CTk):
                                          font=ctk.CTkFont(size=11))
         self.status_label.pack(side="right", padx=10)
 
+        # Project Links
+        links_f = ctk.CTkFrame(footer, fg_color="transparent")
+        links_f.pack(side="left", padx=20)
+
+        ctk.CTkButton(links_f, text="braincleaner.dev",
+                      font=ctk.CTkFont(size=10, underline=True),
+                      fg_color="transparent", text_color=("#1f538d", "#5da7e6"),
+                      hover_color=("#e0e0e0", "#3a3a3a"),
+                      width=80, height=20,
+                      command=lambda: webbrowser.open("https://braincleaner.dev")
+                      ).pack(side="left", padx=2)
+
+        ctk.CTkButton(links_f, text="⭐ Star on GitHub",
+                      font=ctk.CTkFont(size=10, weight="bold"),
+                      fg_color=("#24292e", "#333333"), hover_color=("#2c3137", "#444444"),
+                      text_color="white", width=100, height=22, corner_radius=6,
+                      command=lambda: webbrowser.open("https://github.com/konstantinwdk/brain-cleaner")
+                      ).pack(side="left", padx=5)
+
         # Log Area
         self.log_textbox = ctk.CTkTextbox(main, height=80, font=ctk.CTkFont(size=10))
         self.log_textbox.grid(row=6, column=0, padx=10, pady=(0, 8), sticky="nsew")
@@ -312,10 +349,14 @@ class BrainCleanerApp(ctk.CTk):
             self.scan_header_frame.configure(fg_color="#1f538d")
             self.scan_header_title.configure(text="AI Tools Cleanup")
             self.scan_header_desc.configure(text="Identify and remove cache, logs, and configs left by AI assistants (Gemini, Claude, Cursor...).")
-        else:
+        elif mode == "npm":
             self.scan_header_frame.configure(fg_color="#2e7d32")
             self.scan_header_title.configure(text="NPM Modules Cleanup")
             self.scan_header_desc.configure(text="Free up space by removing heavy node_modules directories from web projects.")
+        elif mode == "python":
+            self.scan_header_frame.configure(fg_color="#3776ab")
+            self.scan_header_title.configure(text="Python Envs Cleanup")
+            self.scan_header_desc.configure(text="Remove obsolete virtual environments (venv, .venv) from your local projects.")
         self.scan_header_count.configure(text="")
 
     # ── Helpers ───────────────────────────────────────────────────
@@ -338,7 +379,9 @@ class BrainCleanerApp(ctk.CTk):
             "Claude": "#d97757",
             "IDE Agents": "#7c4dff",
             "Other Tools": "#546e7a",
-            "Node Modules": "#2e7d32"
+            "Node Modules": "#2e7d32",
+            "Python Envs": "#3776ab",
+            "Python Envs (Obsolete)": "#d32f2f"
         }.get(cat, "#757575")
 
     # ── Info Slider ───────────────────────────────────────────────
@@ -440,6 +483,10 @@ class BrainCleanerApp(ctk.CTk):
             for c in self.NPM_CATS:
                 results[c] = raw.get(c, [])
                 results["All"] += results[c]
+        elif mode == "python":
+            for c in self.PY_CATS:
+                results[c] = raw.get(c, [])
+                results["All"] += results[c]
         self.scanning_active = False
         self.after(0, lambda: self._finish_scan(results, mode))
 
@@ -462,7 +509,7 @@ class BrainCleanerApp(ctk.CTk):
         self.status_label.configure(text=f"Found {total} items — {total_str}")
         self.log(f"Scan complete. {total} items found ({total_str}).")
 
-        found_cats = [c for c in (self.AI_CATS + self.NPM_CATS) if results.get(c)]
+        found_cats = [c for c in (self.AI_CATS + self.NPM_CATS + self.PY_CATS) if results.get(c)]
         self.create_filter_bubbles(["All"] + found_cats)
 
         count = 0
@@ -476,6 +523,11 @@ class BrainCleanerApp(ctk.CTk):
             count = sum(len(results[c]) for c in section_cats)
             for cat in section_cats:
                 self._render_rows(results[cat], cat)
+        elif mode == "python":
+            section_cats = [c for c in self.PY_CATS if results.get(c)]
+            count = sum(len(results[c]) for c in section_cats)
+            for cat in section_cats:
+                self._render_rows(results[cat], cat)
                 
         if count > 0:
             self.scan_header_count.configure(text=f"{count} items")

package/bin/brain-cleaner.js

@@ -4,63 +4,62 @@ const { spawn, execSync } = require('child_process');
 const path = require('path');
 
 /**
- * Enhanced JS Wrapper for Brain Cleaner (Python)
- * Handles auto-installation of dependencies.
+ * Robust JS Wrapper for Brain Cleaner (Python)
+ * Focuses on execution and clear error reporting.
  */
 
-function findPython() {
-    const commands = ['python3', 'python', 'py'];
-    for (const cmd of commands) {
-        try {
-            execSync(`${cmd} --version`, { stdio: 'ignore' });
-            return cmd;
-        } catch (e) {
-            continue;
-        }
-    }
-    return null;
-}
+const COLORS = {
+  red: '\x1b[31m',
+  yellow: '\x1b[33m',
+  cyan: '\x1b[36m',
+  bold: '\x1b[1m',
+  reset: '\x1b[0m'
+};
 
-function checkAndInstallDeps(python) {
-    console.log('\x1b[36mFinalizing Brain Cleaner installation...\x1b[0m');
-    const deps = ['blessed', 'Pillow'];
-    
-    for (const dep of deps) {
-        try {
-            // Check if dependency exists
-            execSync(`${python} -c "import ${dep.toLowerCase()}"`, { stdio: 'ignore' });
-        } catch (e) {
-            console.log(`\x1b[33mDependency '${dep}' not found. Installing...\x1b[0m`);
-            try {
-                execSync(`${python} -m pip install ${dep}`, { stdio: 'inherit' });
-            } catch (pipErr) {
-                console.error(`\x1b[31mFailed to install '${dep}'. Please run 'pip install ${dep}' manually.\x1b[0m`);
-            }
-        }
+function findPython() {
+  const commands = ['python3', 'python', 'py'];
+  for (const cmd of commands) {
+    try {
+      execSync(`${cmd} --version`, { stdio: 'ignore' });
+      return cmd;
+    } catch (e) {
+      continue;
     }
+  }
+  return null;
 }
 
 const python = findPython();
 
 if (!python) {
-    console.error('\x1b[31mError: Python not found!\x1b[0m');
-    console.error('Brain Cleaner requires Python 3.9 or higher.');
-    console.error('Please install Python: https://www.python.org/downloads/');
-    process.exit(1);
+  console.error(`\n${COLORS.red}${COLORS.bold}Error: Python not found!${COLORS.reset}`);
+  console.error(`${COLORS.yellow}Brain Cleaner requires Python 3.9 or higher to operate.${COLORS.reset}`);
+  console.error(`Please install Python: ${COLORS.cyan}https://www.python.org/downloads/${COLORS.reset}\n`);
+  process.exit(1);
 }
 
-// Ensure dependencies are present
-checkAndInstallDeps(python);
-
 // Path to the python entry point
 const scriptPath = path.join(__dirname, '..', 'console', 'brain_cleaner_cli.py');
 const args = process.argv.slice(2);
 
 const pythonProcess = spawn(python, [scriptPath, ...args], {
-    stdio: 'inherit',
-    env: { ...process.env, PYTHONPATH: path.join(__dirname, '..') }
+  stdio: 'inherit',
+  env: { 
+    ...process.env, 
+    PYTHONPATH: path.join(__dirname, '..'),
+    PYTHONIOENCODING: 'utf-8' // Ensure rich terminal output works well
+  }
+});
+
+pythonProcess.on('error', (err) => {
+  console.error(`\n${COLORS.red}Failed to start Brain Cleaner:${COLORS.reset}`, err.message);
+  process.exit(1);
 });
 
 pythonProcess.on('close', (code) => {
-    process.exit(code);
+  if (code !== 0 && code !== null) {
+    console.log(`\n${COLORS.yellow}Note: If you see "ModuleNotFoundError", please run:${COLORS.reset}`);
+    console.log(`${COLORS.bold}npm install${COLORS.reset} again to finalize the setup.\n`);
+  }
+  process.exit(code);
 });

package/bin/postinstall.js

@@ -0,0 +1,69 @@
+#!/usr/bin/env node
+
+const { execSync } = require('child_process');
+const path = require('path');
+const fs = require('fs');
+
+/**
+ * Premium Post-install script for Brain Cleaner
+ * Automatically handles Python dependency setup.
+ */
+
+const COLORS = {
+    cyan: '\x1b[36m',
+    green: '\x1b[32m',
+    yellow: '\x1b[33m',
+    red: '\x1b[31m',
+    bold: '\x1b[1m',
+    reset: '\x1b[0m'
+};
+
+function log(msg, color = COLORS.reset) {
+    console.log(`${color}${msg}${COLORS.reset}`);
+}
+
+function findPython() {
+    const commands = ['python3', 'python', 'py'];
+    for (const cmd of commands) {
+        try {
+            execSync(`${cmd} --version`, { stdio: 'ignore' });
+            return cmd;
+        } catch (e) {
+            continue;
+        }
+    }
+    return null;
+}
+
+async function run() {
+    log('\n── Brain Cleaner CLI Setup ──────────────────', COLORS.cyan + COLORS.bold);
+    
+    const python = findPython();
+    if (!python) {
+        log('⚠️  Python 3.9+ not found in your PATH.', COLORS.yellow);
+        log('Brain Cleaner requires Python to run its core logic.');
+        log('Please install it from https://python.org\n');
+        process.exit(0); // Exit gracefully during install to not break npm flow
+    }
+
+    log(`Found ${COLORS.bold}${python}${COLORS.reset}. Installing dependencies...`, COLORS.cyan);
+
+    const requirementsPath = path.join(__dirname, '..', 'requirements.txt');
+    
+    try {
+        // Use -m pip to ensure we use the pip associated with the detected python
+        execSync(`${python} -m pip install --upgrade pip`, { stdio: 'ignore' });
+        execSync(`${python} -m pip install -r "${requirementsPath}"`, { stdio: 'inherit' });
+        
+        log('\n✅ Dependencies installed successfully!', COLORS.green + COLORS.bold);
+        log('You can now run Brain Cleaner using: ' + COLORS.bold + 'brain-cleaner', COLORS.green);
+        log('────────────────────────────────────────────\n', COLORS.cyan);
+    } catch (error) {
+        log('\n⚠️  Could not install dependencies automatically.', COLORS.yellow);
+        log('This often happens due to permission restrictions.');
+        log(`Please run manually: ${COLORS.bold}${python} -m pip install -r requirements.txt`, COLORS.reset);
+        log('────────────────────────────────────────────\n', COLORS.cyan);
+    }
+}
+
+run();

package/console/brain_cleaner_cli.py

@@ -50,11 +50,12 @@ class BrainCleanerCLI:
     def draw_splash(self):
         content = []
         content.append(self.term.cyan(ASCII_ART))
-        content.append(self.term.bold("\n  Welcome to Brain Cleaner CLI v1.1.0"))
+        content.append(self.term.bold("\n  Welcome to Brain Cleaner CLI v1.2.3"))
         content.append("  " + "-" * 40)
         content.append("\n  Select Mode to begin:")
         content.append(self.term.blue("  [1] AI Tools Cleanup"))
         content.append(self.term.green("  [2] NPM Modules Cleanup"))
+        content.append(self.term.yellow("  [3] Python Envs Cleanup"))
         content.append("\n  Press 'q' to exit")
         
         output = self.term.home + self.term.clear + "\n".join(content)
@@ -82,9 +83,15 @@ class BrainCleanerCLI:
         
         # Mutual exclusivity like GUI
         if mode == 'ai':
-            self.scanner.categories = {k: v for k, v in self.scanner.categories.items() if k != "Node Modules"}
-        else:
+            # AI Categories only
+            ai_cats = ["Gemini", "Claude", "IDE Agents", "Other Tools"]
+            self.scanner.categories = {k: v for k, v in self.scanner.categories.items() if k in ai_cats}
+        elif mode == 'npm':
             self.scanner.categories = {k: v for k, v in self.scanner.categories.items() if k == "Node Modules"}
+        elif mode == 'python':
+            # Both Python Envs and Python Envs (Obsolete) are captured by the scanner.py logic
+            self.scanner.categories = {k: v for k, v in self.scanner.categories.items() if k == "Python Envs"}
+        
         self.scanner.all_patterns = [p for patterns in self.scanner.categories.values() for p in patterns]
         
         self.status_msg = f"Scanning {mode.upper()} residues in {scan_root}..."
@@ -270,6 +277,9 @@ class BrainCleanerCLI:
                     elif val == '2':
                         self.mode = 'npm'
                         state = "SELECT_PATH"
+                    elif val == '3':
+                        self.mode = 'python'
+                        state = "SELECT_PATH"
                     elif val.lower() == 'q':
                         return
 

package/package.json

@@ -1,13 +1,14 @@
 {
   "name": "brain-cleaner",
-  "version": "1.2.2",
+  "version": "1.2.4",
   "description": "Professional CLI utility to reclaim disk space by removing residues from AI tools (Gemini, Claude, Cursor) and heavy node_modules folders. Optimized for system performance and digital decluttering.",
   "main": "bin/brain-cleaner.js",
   "bin": {
     "brain-cleaner": "bin/brain-cleaner.js"
   },
   "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1"
+    "test": "echo \"Error: no test specified\" && exit 1",
+    "postinstall": "node bin/postinstall.js"
   },
   "repository": {
     "type": "git",
@@ -34,6 +35,7 @@
     "developer-tools"
   ],
   "engines": {
-    "node": ">=14.0.0"
+    "node": ">=14.0.0",
+    "python": ">=3.9"
   }
 }

package/scanner.py

@@ -1,5 +1,6 @@
 import os
 import shutil
+import time
 from pathlib import Path
 
 class BrainScanner:
@@ -28,6 +29,7 @@ class BrainScanner:
                 ".github-copilot",
                 "brain-recordings"
             ],
+            "Python Envs": ["venv", ".venv", "env", ".env", "virtualenv", "pyenv"],
             "Node Modules": ["node_modules"]
         }
         # Flattened list for the walker
@@ -78,8 +80,9 @@ class BrainScanner:
         
         for cat, path, size_str, size_bytes in self.scan_stream(start_path, interrupt_event):
             item = (path, size_str, size_bytes)
-            if cat in found:
-                found[cat].append(item)
+            if cat not in found:
+                found[cat] = []
+            found[cat].append(item)
             found["All"].append(item)
             
         # Sort by path
@@ -107,6 +110,22 @@ class BrainScanner:
                     for cat, patterns in self.categories.items():
                         if d in patterns or any(d.startswith(p) for p in patterns):
                             full_path = os.path.join(root, d)
+                            
+                            # Verify if it's a real Python Virtual Env
+                            if cat == "Python Envs":
+                                cfg_path = os.path.join(full_path, "pyvenv.cfg")
+                                if not os.path.exists(cfg_path):
+                                    continue
+                                
+                                # Check obsolescence (90 days)
+                                try:
+                                    mtime = os.path.getmtime(cfg_path)
+                                    days_old = (time.time() - mtime) / (24 * 3600)
+                                    if days_old > 90:
+                                        cat = "Python Envs (Obsolete)"
+                                except Exception:
+                                    pass
+
                             size_bytes = self.get_dir_size(full_path)
                             size_str = self.format_size(size_bytes)