claude-cleaner

🇪🇸 Español · 🇬🇧 English

---

Español

Herramienta de línea de comandos para inspeccionar y limpiar las sesiones de Claude (app de escritorio) en macOS.

Las sesiones del modo agente se almacenan como ficheros JSON en:

~/Library/Application Support/Claude/local-agent-mode-sessions/<guid>/<guid>/local_*.json

Con el tiempo se acumulan decenas de sesiones archivadas que ocupan espacio en disco. La app de Claude solo permite archivarlas, pero no recuperarlas ni eliminarlas. claude-cleaner cubre esa carencia permitiendo inspeccionarlas y (próximamente) eliminarlas directamente desde la terminal.

Requisitos

• macOS
• Python 3.10+ (incluido en el sistema, sin dependencias externas)
• Claude para escritorio instalado

Uso

python3 claude-cleaner.py

Ejemplo de salida:

TITLE                                    STATUS     MODEL                  LAST ACTIVITY        SIZE
──────────────────────────────────────────────────────────────────────────────────────────────────────
Improve NAS SSH authentication security  active     claude-sonnet-4-6      2026-04-21 20:29     2 MB
HomeLab - Arr                            active     claude-sonnet-4-6      2026-04-19 20:25   512 KB
HomeLab - CrowdSec                       archived   claude-haiku-4-5       2026-04-19 16:19     1 MB
HealthyLife - Fase 0                     active     claude-sonnet-4-6      2026-04-19 11:33   256 KB
...

Total: 34  active: 14  archived: 20  size: 48 MB (archived: 22 MB)

Los resultados se ordenan por actividad más reciente.

Campos mostrados

Campo	Descripción
TITLE	Título de la sesión (o nombre de proceso si no tiene título)
STATUS	active o archived
MODEL	Modelo de Claude usado en la sesión
LAST ACTIVITY	Fecha y hora de la última actividad
SIZE	Tamaño en disco de los datos de la conversación

Roadmap

• Filtrar por estado (solo activas / solo archivadas)
• Eliminar sesiones archivadas
• Mostrar mensaje inicial de la conversación
• Modo interactivo para seleccionar y borrar

Licencia

MIT

↑ Volver arriba

---

English

Command-line tool to inspect and clean Claude desktop app sessions on macOS.

Agent mode sessions are stored as JSON files at:

~/Library/Application Support/Claude/local-agent-mode-sessions/<guid>/<guid>/local_*.json

Over time, dozens of archived sessions accumulate and take up disk space. The Claude app only lets you archive them — there is no way to restore or delete them from within the app. claude-cleaner fills that gap, letting you inspect them (and soon delete them) directly from your terminal.

Requirements

• macOS
• Python 3.10+ (included with the OS, no external dependencies)
• Claude for desktop installed

Usage

python3 claude-cleaner.py

Sample output:

TITLE                                    STATUS     MODEL                  LAST ACTIVITY        SIZE
──────────────────────────────────────────────────────────────────────────────────────────────────────
Improve NAS SSH authentication security  active     claude-sonnet-4-6      2026-04-21 20:29     2 MB
HomeLab - Arr                            active     claude-sonnet-4-6      2026-04-19 20:25   512 KB
HomeLab - CrowdSec                       archived   claude-haiku-4-5       2026-04-19 16:19     1 MB
HealthyLife - Fase 0                     active     claude-sonnet-4-6      2026-04-19 11:33   256 KB
...

Total: 34  active: 14  archived: 20  size: 48 MB (archived: 22 MB)

Results are sorted by most recent activity.

Fields

Field	Description
TITLE	Session title (or process name if untitled)
STATUS	active or archived
MODEL	Claude model used in the session
LAST ACTIVITY	Date and time of last activity
SIZE	Disk size of the conversation data

Roadmap

• Filter by status (active only / archived only)
• Delete archived sessions
• Show first message of the conversation
• Interactive mode to select and delete

License

MIT

↑ Back to top