brain-cleaner 1.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.es.md +81 -0
- package/README.md +97 -0
- package/app.py +709 -0
- package/assets/icon.png +0 -0
- package/assets/icon_original.png +0 -0
- package/assets/icon_ui.png +0 -0
- package/bin/brain-cleaner.js +48 -0
- package/console/README.md +43 -0
- package/console/brain_cleaner_cli.py +379 -0
- package/package.json +29 -0
- package/scanner.py +146 -0
package/README.es.md
ADDED
|
@@ -0,0 +1,81 @@
|
|
|
1
|
+
# Brain Cleaner
|
|
2
|
+
|
|
3
|
+
**Language / Idioma:**
|
|
4
|
+
[🇬🇧 English](https://github.com/konstantinWDK/brain-cleaner/blob/main/README.md) | 🇪🇸 Español
|
|
5
|
+
|
|
6
|
+
[](https://www.python.org/downloads/)
|
|
7
|
+
[](https://opensource.org/licenses/MIT)
|
|
8
|
+
[](https://www.apple.com/macos/)
|
|
9
|
+
|
|
10
|
+
---
|
|
11
|
+
|
|
12
|
+
**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.
|
|
13
|
+
|
|
14
|
+
## Características Principales
|
|
15
|
+
|
|
16
|
+
- Limpiador de IA — Detecta y elimina caché, logs y configuraciones de asistentes de IA.
|
|
17
|
+
- Revisor de NPM — Libera espacio en disco detectando y eliminando carpetas `node_modules` de proyectos web.
|
|
18
|
+
- Selección Granular — Árbol de archivos interactivo para revisar y excluir dependencias individuales antes de borrar.
|
|
19
|
+
|
|
20
|
+
## Inicio Rápido (Instalación y Ejecución)
|
|
21
|
+
|
|
22
|
+
### Instalación (Modo Consola)
|
|
23
|
+
|
|
24
|
+
Para instalar **Brain Cleaner** como un comando global en tu terminal:
|
|
25
|
+
|
|
26
|
+
1. **Clonar el repositorio**:
|
|
27
|
+
```bash
|
|
28
|
+
git clone https://github.com/konstantinwdk/brain-cleaner.git
|
|
29
|
+
```
|
|
30
|
+
2. **Navegar a la carpeta**:
|
|
31
|
+
```bash
|
|
32
|
+
cd brain-cleaner
|
|
33
|
+
```
|
|
34
|
+
3. **Instalar el paquete**:
|
|
35
|
+
```bash
|
|
36
|
+
pip install .
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
### Instalación (Modo NPM)
|
|
40
|
+
Si prefieres usar NPM, puedes instalarlo globalmente:
|
|
41
|
+
```bash
|
|
42
|
+
npm install -g brain-cleaner
|
|
43
|
+
```
|
|
44
|
+
*Nota: Requiere tener Python 3.9+ instalado en el sistema.*
|
|
45
|
+
|
|
46
|
+
## Uso
|
|
47
|
+
|
|
48
|
+
Una vez instalado, puedes arrancar la **Consola Interactiva (CLI)** desde cualquier directorio:
|
|
49
|
+
|
|
50
|
+
```bash
|
|
51
|
+
brain-cleaner
|
|
52
|
+
```
|
|
53
|
+
*Consejo: Usa el CLI para una limpieza rápida gestionada totalmente por teclado.*
|
|
54
|
+
|
|
55
|
+
> [!TIP]
|
|
56
|
+
> En macOS usa Python de Homebrew para evitar cierres inesperados: `brew install python@3.11`
|
|
57
|
+
|
|
58
|
+
## Uso
|
|
59
|
+
|
|
60
|
+
1. **Ubicación** — Elige `Home`, `Full System` o `Custom Folder` en la barra lateral.
|
|
61
|
+
2. **Modo** — Elige entre `AI Tools` o `NPM Modules` según lo que quieras escanear.
|
|
62
|
+
3. **Escanear** — Pulsa `START SCAN`. Los resultados aparecen en dos secciones diferenciadas.
|
|
63
|
+
4. **Revisar** — Haz clic en `›` para desplegar el contenido de una carpeta. Puedes marcar o desmarcar elementos individuales.
|
|
64
|
+
5. **Limpiar** — Usa `Clean Selected` para los elementos marcados o `Clean All (Visible)` para todo lo visible en el filtro activo.
|
|
65
|
+
|
|
66
|
+
> [!WARNING]
|
|
67
|
+
> La eliminación es **permanente**. No hay papelera de reciclaje. Revisa bien antes de limpiar.
|
|
68
|
+
|
|
69
|
+
## Categorías Detectadas
|
|
70
|
+
|
|
71
|
+
| Categoría | Herramientas |
|
|
72
|
+
|---|---|
|
|
73
|
+
| **Gemini** | Caché de la CLI / API de Google Gemini |
|
|
74
|
+
| **Claude** | Logs y configuración de Anthropic Claude |
|
|
75
|
+
| **IDE Agents** | Cursor, Windsurf, Trae, Roo-Code, Claude-Dev |
|
|
76
|
+
| **Other Tools** | Herramientas de IA no categorizadas |
|
|
77
|
+
| **Node Modules** | Carpetas `node_modules` en proyectos Node.js |
|
|
78
|
+
|
|
79
|
+
## Licencia
|
|
80
|
+
|
|
81
|
+
MIT — *Desarrollado para mantener tu sistema libre de ruido digital.*
|
package/README.md
ADDED
|
@@ -0,0 +1,97 @@
|
|
|
1
|
+
# Brain Cleaner
|
|
2
|
+
|
|
3
|
+
**Language / Idioma:**
|
|
4
|
+
🇬🇧 English | [🇪🇸 Español](https://github.com/konstantinWDK/brain-cleaner/blob/main/README.es.md)
|
|
5
|
+
|
|
6
|
+
[](https://www.python.org/downloads/)
|
|
7
|
+
[](https://opensource.org/licenses/MIT)
|
|
8
|
+
[](https://www.apple.com/macos/)
|
|
9
|
+
|
|
10
|
+
---
|
|
11
|
+
|
|
12
|
+
**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.
|
|
13
|
+
|
|
14
|
+
## Core Features
|
|
15
|
+
|
|
16
|
+
- AI Tools Cleaner — Detects and cleans configuration, cache, and logs from AI assistants.
|
|
17
|
+
- NPM Cleaner — Reclaims disk space by detecting and removing heavy `node_modules` folders.
|
|
18
|
+
- Granular Selection — Interactive file tree to review and exclude individual files from deletion.
|
|
19
|
+
|
|
20
|
+
## Quick Start
|
|
21
|
+
|
|
22
|
+
### Installation (CLI Mode)
|
|
23
|
+
|
|
24
|
+
To install **Brain Cleaner** as a global command in your terminal:
|
|
25
|
+
|
|
26
|
+
1. **Clone the repository**:
|
|
27
|
+
```bash
|
|
28
|
+
git clone https://github.com/konstantinwdk/brain-cleaner.git
|
|
29
|
+
```
|
|
30
|
+
2. **Navigate to the folder**:
|
|
31
|
+
```bash
|
|
32
|
+
cd brain-cleaner
|
|
33
|
+
```
|
|
34
|
+
3. **Install the package**:
|
|
35
|
+
```bash
|
|
36
|
+
pip install .
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
### Installation (NPM Mode)
|
|
40
|
+
If you are coming from the Node.js ecosystem, you can install it globally via NPM:
|
|
41
|
+
```bash
|
|
42
|
+
npm install -g brain-cleaner
|
|
43
|
+
```
|
|
44
|
+
*Note: Requires Python 3.9+ installed on your system.*
|
|
45
|
+
|
|
46
|
+
## Installation
|
|
47
|
+
|
|
48
|
+
To install this console interface as a global command:
|
|
49
|
+
|
|
50
|
+
1. Open your terminal in the root directory of the project.
|
|
51
|
+
2. Run:
|
|
52
|
+
```bash
|
|
53
|
+
pip install .
|
|
54
|
+
```
|
|
55
|
+
|
|
56
|
+
## Quick Start
|
|
57
|
+
|
|
58
|
+
Once installed, you can run the interactive interface from anywhere:
|
|
59
|
+
|
|
60
|
+
```bash
|
|
61
|
+
brain-cleaner
|
|
62
|
+
```
|
|
63
|
+
*Tip: Use the CLI for fast, keyboard-driven system cleaning.*
|
|
64
|
+
|
|
65
|
+
> [!IMPORTANT]
|
|
66
|
+
> **macOS 26 (Tahoe) Compatibility**: Use Homebrew Python 3.11 or later to avoid "macOS 26 required" errors in GUI mode.
|
|
67
|
+
> ```bash
|
|
68
|
+
> brew install python@3.11 python-tk@3.11
|
|
69
|
+
> python3.11 -m venv .venv
|
|
70
|
+
> source .venv/bin/activate
|
|
71
|
+
> pip install .
|
|
72
|
+
> ```
|
|
73
|
+
|
|
74
|
+
## Usage
|
|
75
|
+
|
|
76
|
+
1. **Scope** — Choose `Home`, `Full System` or `Custom Folder` in the sidebar.
|
|
77
|
+
2. **Mode** — Choose between `AI Tools` or `NPM Modules` to set what to scan.
|
|
78
|
+
3. **Scan** — Click `START SCAN`. Results appear in two labeled sections.
|
|
79
|
+
4. **Review** — Click `›` on any row to expand its subfolders. Check/uncheck individual items.
|
|
80
|
+
5. **Clean** — Use `Clean Selected` for marked items or `Clean All (Visible)` for everything in the active filter.
|
|
81
|
+
|
|
82
|
+
> [!WARNING]
|
|
83
|
+
> Deletion is **permanent**. There is no recycle bin. Review carefully before cleaning.
|
|
84
|
+
|
|
85
|
+
## Detected Categories
|
|
86
|
+
|
|
87
|
+
| Category | Tools |
|
|
88
|
+
|---|---|
|
|
89
|
+
| **Gemini** | Google Gemini CLI / API cache |
|
|
90
|
+
| **Claude** | Anthropic Claude logs & config |
|
|
91
|
+
| **IDE Agents** | Cursor, Windsurf, Trae, Roo-Code, Claude-Dev |
|
|
92
|
+
| **Other Tools** | Uncategorized AI tools |
|
|
93
|
+
| **Node Modules** | `node_modules` in Node.js projects |
|
|
94
|
+
|
|
95
|
+
## License
|
|
96
|
+
|
|
97
|
+
MIT — *Developed to keep your system free of digital noise.*
|