brain-cleaner 1.2.1 → 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/package.json

@@ -1,7 +1,7 @@
 {
   "name": "brain-cleaner",
-  "version": "1.2.1",
-  "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"
+  }
 }