brain-cleaner 1.2.3 → 1.2.5

package/README.es.md

@@ -1,85 +1,100 @@
 # Brain Cleaner
 
-[![NPM Version](https://img.shields.io/npm/v/brain-cleaner.svg)](https://www.npmjs.com/package/brain-cleaner)
-[![Licencia: MIT](https://img.shields.io/badge/Licencia-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/)
+![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 Demostración de Interfaz](./assets/ui-demo.png)
+![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/)
 
 ---
 
-## ¿Por qué Brain Cleaner?
+### 🚀 Instalación Recomendada (Global)
+Instala directamente desde NPM para obtener la última versión estable:
+
+```bash
+npm install -g brain-cleaner
+```
 
-En la era del desarrollo moderno, nuestros sistemas se llenan constantemente de "ruido digital". Cada interacción con asistentes de IA (Gemini, Claude, Cursor), cada proyecto NPM y cada experimento en Python dejan un rastro de registros, caché y entornos virtuales pesados que rápidamente consumen cientos de gigabytes de espacio en disco.
+#### Alternativa: Instalación desde el Código Fuente (Python)
+Si prefieres instalar vía Python/Pip directamente desde el repositorio:
 
-**Brain Cleaner nació para solucionar esto.** Ofrece una interfaz profesional de alto rendimiento para recuperar espacio en disco, atacando precisamente esos residuos de desarrollo que los limpiadores estándar pasan por alto.
+```bash
+pip install git+https://github.com/konstantinwdk/brain-cleaner
+```
 
 ---
 
-## 🚀 Características Principales
-
-- **Limpiador de Residuos de IA** — Escaneo profundo de caché, logs y configuraciones de Gemini, Claude, Cursor, Windsurf, Trae y más.
-- **Optimización NPM** — Encuentra y elimina de forma segura carpetas `node_modules` pesadas de proyectos olvidados.
-- **Gestión de Entornos Python** — Detecta entornos virtuales obsoletos (`venv`, `.venv`) que no se han tocado en más de 90 días.
-- **Potencia Híbrida** — La facilidad de una instalación global de NPM con el motor de escaneo de alto rendimiento de Python.
-- **Interfaz Interactiva** — Elige entre una elegante GUI de escritorio o una interfaz de línea de comandos (CLI) profesional.
+### 🚀 Requisitos
+- Se requiere **Python 3.9+**.
+- **Node.js 14+** (si se instala por NPM).
 
 ---
 
-## ⚙️ Instalación
+## Inicio Rápido (Instalación y Ejecución)
+
+### Instalación (Modo Consola)
 
-Instala globalmente a través de NPM para empezar a limpiar inmediatamente:
+Para instalar **Brain Cleaner** como un comando global en tu terminal:
 
+1. **Clonar el repositorio**:
+   ```bash
+   git clone https://github.com/konstantinwdk/brain-cleaner.git
+   ```
+2. **Navegar a la carpeta**:
+   ```bash
+   cd brain-cleaner
+   ```
+3. **Instalar el paquete**:
+   ```bash
+   pip install .
+   ```
+
+### Instalación (Modo NPM)
+Si prefieres usar NPM, puedes instalarlo globalmente:
 ```bash
 npm install -g brain-cleaner
 ```
+*Nota: Requiere tener Python 3.9+ instalado en el sistema.*
 
-### Requisitos
-- **Python 3.9+** (Requerido para el motor de escaneo).
-- **Node.js 14+**.
-
----
+## Uso
 
-## 📖 Cómo Usar
+Una vez instalado, puedes arrancar la **Consola Interactiva (CLI)** desde cualquier directorio:
 
-### 1. Iniciar la Interfaz
-Simplemente ejecuta el comando desde cualquier terminal:
 ```bash
 brain-cleaner
 ```
+*Consejo: Usa el CLI para una limpieza rápida gestionada totalmente por teclado.*
 
-### 2. Elige el Alcance
-Selecciona en la barra lateral entre escanear tu directorio **Home**, el **Sistema Completo** o una **Carpeta Personalizada**.
-
-### 3. Selecciona Modo y Escanea
-- **AI Tools**: Para logs y caché de asistentes de IA.
-- **NPM Modules**: Para carpetas `node_modules` pesadas.
-- **Python Envs**: Para identificar entornos virtuales abandonados.
-
-### 4. Revisa y Limpia
-Despliega las entradas para revisar las subcarpetas, marca elementos individuales y haz clic en **Clean Selected** o **Clean All**.
-
----
-
-## 🛠 Detalles Técnicos
-
-Aunque se distribuye a través de NPM, Brain Cleaner es una herramienta híbrida. El wrapper de Node.js automáticamente:
-1. Detecta tu entorno local de Python.
-2. Auto-instala las dependencias principales (`customtkinter`, `blessed`, `Pillow`) en la primera ejecución.
-3. Ejecuta de forma segura el motor de limpieza multiplataforma.
+> [!TIP]
+> En macOS usa Python de Homebrew para evitar cierres inesperados: `brew install python@3.11`
 
----
+## Uso
 
-## ⚠️ Seguridad Primero
+1. **Ubicación** — Elige `Home`, `Full System` o `Custom Folder` en la barra lateral.
+2. **Modo** — Elige entre `AI Tools` o `NPM Modules` según lo que quieras escanear.
+3. **Escanear** — Pulsa `START SCAN`. Los resultados aparecen en dos secciones diferenciadas.
+4. **Revisar** — Haz clic en `›` para desplegar el contenido de una carpeta. Puedes marcar o desmarcar elementos individuales.
+5. **Limpiar** — Usa `Clean Selected` para los elementos marcados o `Clean All (Visible)` para todo lo visible en el filtro activo.
 
 > [!WARNING]
-> La eliminación es **permanente**. Brain Cleaner no mueve archivos a la papelera; los elimina para recuperar espacio inmediatamente. Siempre revisa los resultados del escaneo antes de confirmar la limpieza.
+> La eliminación es **permanente**. No hay papelera de reciclaje. Revisa bien antes de limpiar.
 
----
+## Categorías Detectadas
+
+| Categoría | Herramientas |
+|---|---|
+| **Gemini** | Caché de la CLI / API de Google Gemini |
+| **Claude** | Logs y configuración de Anthropic Claude |
+| **IDE Agents** | Cursor, Windsurf, Trae, Roo-Code, Claude-Dev |
+| **Other Tools** | Herramientas de IA no categorizadas |
+| **Node Modules** | Carpetas `node_modules` en proyectos Node.js |
 
-## 📄 Licencia
+## Licencia
 
-MIT — *Desarrollado para mantener tu sistema de desarrollo ligero y enfocado.*
+MIT — *Desarrollado para mantener tu sistema libre de ruido digital.*

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,7 +9,7 @@
 **Language / Idioma:**
 🇬🇧 English  |  [🇪🇸 Español](https://github.com/konstantinWDK/brain-cleaner/blob/main/README.es.md)
 
-![Brain Cleaner UI Demo](./assets/ui-demo.png)
+![Brain Cleaner UI Mockup](https://braincleaner.dev/mockup.png)
 
 ---
 

package/app.py

@@ -90,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.2.3",
+        ctk.CTkLabel(title_f, text="v1.2.5",
                      font=ctk.CTkFont(size=11, slant="italic"), text_color="#a1a1a1"
                      ).pack()
 

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,7 +50,7 @@ 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.2.3"))
+        content.append(self.term.bold("\n  Welcome to Brain Cleaner CLI v1.2.5"))
         content.append("  " + "-" * 40)
         content.append("\n  Select Mode to begin:")
         content.append(self.term.blue("  [1] AI Tools Cleanup"))

package/package.json

@@ -1,13 +1,14 @@
 {
   "name": "brain-cleaner",
-  "version": "1.2.3",
+  "version": "1.2.5",
   "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",

package/assets/ui-demo.png

@@ -1 +0,0 @@
-IMAGE_DATA_ATTACHED