brain-cleaner 1.2.0 → 1.2.2

package/README.es.md

@@ -1,7 +1,7 @@
 # Brain Cleaner
 
 **Language / Idioma:**
-[🇬🇧 English](https://github.com/konstantinWDK/brain-cleaner/blob/main/README.md)  |  🇪🇸 Español
+🇪🇸 Español  |  [🇬🇧 English](https://github.com/konstantinWDK/brain-cleaner/blob/main/README.md)
 
 [![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)
@@ -9,13 +9,27 @@
 
 ---
 
-**Brain Cleaner** es una utilidad de escritorio para encontrar y eliminar archivos residuales dejados por herramientas de IA (Gemini, Claude, Cursor, Windsurf…) y carpetas `node_modules` pesadas.
+### 🚀 Instalación Recomendada (Global)
+Instala directamente desde NPM para obtener la última versión estable:
 
-## Características Principales
+```bash
+npm install -g brain-cleaner
+```
 
-- Limpiador de IA — Detecta y elimina caché, logs y configuraciones de asistentes de IA.
-- Revisor de NPM — Libera espacio en disco detectando y eliminando carpetas `node_modules` de proyectos web.
-- Selección Granular — Árbol de archivos interactivo para revisar y excluir dependencias individuales antes de borrar.
+#### Alternativa: Instalación desde el Código Fuente (Python)
+Si prefieres instalar vía Python/Pip directamente desde el repositorio:
+
+```bash
+pip install git+https://github.com/konstantinwdk/brain-cleaner
+```
+
+---
+
+### 🚀 Requisitos
+- Se requiere **Python 3.9+**.
+- **Node.js 14+** (si se instala por NPM).
+
+---
 
 ## Inicio Rápido (Instalación y Ejecución)
 

package/README.md

@@ -1,33 +1,45 @@
 # Brain Cleaner
 
+[![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/)
+
 **Language / Idioma:**
 🇬🇧 English  |  [🇪🇸 Español](https://github.com/konstantinWDK/brain-cleaner/blob/main/README.es.md)
 
-[![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-[![Platform macOS](https://img.shields.io/badge/platform-macOS-lightgrey.svg)](https://www.apple.com/macos/)
-
 ---
 
-**Brain Cleaner** is a desktop utility to find and remove residual files left by AI tools (Gemini, Claude, Cursor, Windsurf…) and heavy `node_modules` folders from your system.
+**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.
 
-## Core Features
+### ⚙️ 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.
 
-- AI Tools Cleaner — Detects and cleans configuration, cache, and logs from AI assistants.
-- NPM Cleaner — Reclaims disk space by detecting and removing heavy `node_modules` folders.
-- Granular Selection — Interactive file tree to review and exclude individual files from deletion.
+### 🚀 Recommended Installation (Global)
+Install directly from NPM to get the latest stable version:
 
-## Quick Start
+```bash
+npm install -g brain-cleaner
+```
 
-### Installation (CLI Mode)
+#### Alternative: Install from Source (Python)
+If you prefer to install via Python/Pip directly from the repository:
 
-To install **Brain Cleaner** as a global command in your terminal:
+```bash
+pip install git+https://github.com/konstantinwdk/brain-cleaner
+```
+
+### 🚀 Requirements
+- **Python 3.9+** is required.
+- **Node.js 14+** (if installing via NPM).
+
+## Quick Start
 
-1. **Clone the repository**:
-   ```bash
-   git clone https://github.com/konstantinwdk/brain-cleaner.git
-   ```
-2. **Navigate to the folder**:
    ```bash
    cd brain-cleaner
    ```

package/bin/brain-cleaner.js

@@ -1,17 +1,15 @@
 #!/usr/bin/env node
 
-const { spawn } = require('child_process');
+const { spawn, execSync } = require('child_process');
 const path = require('path');
-const fs = require('fs');
 
 /**
- * JS Wrapper for Brain Cleaner (Python)
+ * Enhanced JS Wrapper for Brain Cleaner (Python)
+ * Handles auto-installation of dependencies.
  */
 
 function findPython() {
-    const commands = ['python3', 'python'];
-    const { execSync } = require('child_process');
-    
+    const commands = ['python3', 'python', 'py'];
     for (const cmd of commands) {
         try {
             execSync(`${cmd} --version`, { stdio: 'ignore' });
@@ -23,21 +21,41 @@ function findPython() {
     return null;
 }
 
+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`);
+            }
+        }
+    }
+}
+
 const python = findPython();
 
 if (!python) {
     console.error('\x1b[31mError: Python not found!\x1b[0m');
-    console.error('Brain Cleaner requires Python 3.9 or higher to run.');
-    console.error('Please install Python and try again: https://www.python.org/downloads/');
+    console.error('Brain Cleaner requires Python 3.9 or higher.');
+    console.error('Please install Python: https://www.python.org/downloads/');
     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');
-
-// Since we are running from NPM, we might need to ensure dependencies are installed
-// For now, we just pass the arguments to the python script
 const args = process.argv.slice(2);
+
 const pythonProcess = spawn(python, [scriptPath, ...args], {
     stdio: 'inherit',
     env: { ...process.env, PYTHONPATH: path.join(__dirname, '..') }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "brain-cleaner",
-  "version": "1.2.0",
-  "description": "System residue cleaner for AI tools and NPM modules",
+  "version": "1.2.2",
+  "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"
@@ -9,6 +9,14 @@
   "scripts": {
     "test": "echo \"Error: no test specified\" && exit 1"
   },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/konstantinwdk/brain-cleaner.git"
+  },
+  "bugs": {
+    "url": "https://github.com/konstantinwdk/brain-cleaner/issues"
+  },
+  "homepage": "https://github.com/konstantinwdk/brain-cleaner#readme",
   "author": "Konstantin <info@webdesignerk.com>",
   "license": "MIT",
   "keywords": [
@@ -17,13 +25,15 @@
     "system",
     "npm",
     "node_modules",
-    "disk-space"
+    "disk-space",
+    "ai-tools-cleaner",
+    "gemini",
+    "claude",
+    "cursor-cleaner",
+    "cleanup-utility",
+    "developer-tools"
   ],
   "engines": {
     "node": ">=14.0.0"
-  },
-  "bugs": {
-    "url": "https://github.com/konstantinwdk/brain-cleaner/issues"
-  },
-  "homepage": "https://github.com/konstantinwdk/brain-cleaner#readme"
+  }
 }