bodega
Manages Android emulator storage and can relocate AVD data to an external drive via ANDROID_AVD_HOME.
Detects and cleans CocoaPods caches and Pods directories in Apple-platform projects.
Cleans Dart/Flutter artifacts such as .dart_tool and pub caches, and manages Dart daemons.
Inventories .env files, checks whether they are tracked by Git, and backs them up in an encrypted vault.
Finds and cleans Flutter build artifacts such as build/ and .dart_tool when a pubspec.yaml identifies the project.
Inspects local Git repositories for uncommitted changes and versioned secrets.
Cleans Gradle caches, relocates GRADLE_USER_HOME, and stops Gradle daemons.
Detects and cleans Homebrew cache data.
Manages iOS simulator caches and related Xcode data.
Detects and stops Kotlin daemons that remain running.
Cleans .NET build outputs such as bin/ and obj/ next to .csproj files, manages NuGet caches, and stops .NET daemons.
Cleans Node.js project dependencies such as node_modules and manages Node-related caches.
Detects and cleans npm caches.
Cleans NuGet caches and can relocate NUGET_PACKAGES to an external drive.
Detects and cleans pnpm caches.
Cleans Python virtual environments such as .venv.
Cleans Rust target/ build directories.
Cleans Xcode caches and can relocate Xcode Archives to an external drive.
Detects and cleans Yarn caches.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Bodega
Administra el espacio de tu Mac de desarrollo. Bodega te dice qué ocupa el disco, cuánto puedes recuperar sin perder nada, qué proyecto tiene servidores abiertos, qué puede vivir en un disco externo y dónde están las llaves de firma que no te puedes dar el lujo de perder.
Corre en tu Mac, en http://localhost:2633 (en el teclado de un teléfono se escribe B-O-D-E). Sin nube, sin cuentas, sin telemetría.

Qué hace
Limpieza con plan. Encuentra los compilados de cada proyecto (
build,bin,obj,.dart_tool,node_modules,target,Pods,.venv…) y las cachés globales (Xcode, simuladores, Gradle, npm, Yarn, pnpm, NuGet, pub, CocoaPods, Homebrew). Arma un plan con el tamaño, el comando exacto y cómo vuelve cada cosa. Puedes simularlo antes de aplicarlo.Proyectos. Tamaño real contra compilados, tecnologías detectadas, último cambio, cambios sin commit, puertos abiertos y secretos. Limpias uno o lo mueves a otro disco con copia verificada, dejando un acceso en su ruta original para que tu IDE y tu terminal sigan igual. Se regresa con un clic.
Procesos y puertos. Cada puerto que escucha con el proyecto que lo abrió (por la carpeta del proceso), su memoria, y los daemons que se quedan vivos (Gradle, Kotlin, .NET, Dart). Los detienes con confirmación.
Discos. Uso por tipo, formato, cifrado y permisos de cada disco. Reubica al disco externo los emuladores de Android, Gradle, NuGet, pub y los Archives de Xcode con la variable oficial de cada herramienta (
ANDROID_AVD_HOME,GRADLE_USER_HOME,NUGET_PACKAGES,PUB_CACHE).Bóveda. Inventario de llaves de firma (
.jks,.keystore,.p12),key.properties, certificados,google-services.jsony.env, y te avisa cuáles están versionados en git. Los respalda en una imagen cifrada AES-256 en tu disco externo con SHA-256 por archivo. Nunca muestra su contenido.Escritorio. Ordena Escritorio y Descargas por tipo (capturas, notas, PDF, instaladores) sin borrar nada.
Claude Code. Un servidor MCP expone las mismas funciones; lo que modifica algo pide tu confirmación.

Related MCP server: Local Dev Bridge MCP
Seguridad
Lo regenerable se borra porque vuelve solo con la siguiente compilación o descarga. Lo tuyo (proyectos, archivos, Archives) nunca se borra: se mueve o va a la Papelera.
Una carpeta sólo cuenta como compilado si su ecosistema lo dice:
binyobjjunto a un.csproj,node_modulesjunto apackage.json,buildjunto apubspec.yaml,build.gradleoPodfile. Unbuild/de documentación no se toca.Nunca opera fuera de tu carpeta de usuario o de un volumen externo, ni sobre
/,~o carpetas del sistema. Nunca borra a través de enlaces simbólicos.El servidor escucha sólo en
127.0.0.1, exige un token por instalación (~/.bodega/token), rechaza otrosHostyOriginy sólo ejecuta acciones del último plan por ID, nunca rutas que mande el navegador.Detener procesos: sólo los del último listado, de tu usuario y nunca a Bodega; SIGTERM y, a los 5 s, SIGKILL.
Requisitos
macOS (probado en macOS 26).
Node.js 22.18 o más nuevo: Bodega corre TypeScript directo, sin compilar el motor.
Instalación
git clone https://github.com/ReyDavidAG/bodega.git
cd bodega
npm ci
npm run build # compila el dashboard
npm link # deja el comando `bodega` disponible
bodega install # lo arranca con tu sesión (LaunchAgent)
bodega open # http://localhost:2633Si no quieres que corra siempre: bodega serve en una terminal y bodega uninstall para quitar el LaunchAgent.
App de escritorio (opcional)
Bodega también se abre como app de macOS, Bodega.app, hecha con Tauri y que vive en la barra de menú:
Abre el mismo dashboard en su propia ventana, sin pestaña de navegador.
Desde la barra de menú ves el espacio libre y el último escaneo, escaneas, lo abres en el navegador o lo activas al iniciar sesión.
Te avisa cuando el disco interno baja del umbral de Ajustes (20 GB por omisión).
Si el motor no está corriendo, lo arranca con un clic.
La app es sólo una ventana: el motor sigue siendo el mismo (bodega install) y la app nunca toca archivos ni procesos por su cuenta. No se publica ejecutable; se compila en tu Mac:
# Requiere Rust (https://rustup.rs) y las herramientas de Xcode
npm ci
npm run desktop:build
open desktop/src-tauri/target/release/bundle/macos/Bodega.appLleva firma ad-hoc, así que funciona en la Mac donde la compilas. Cópiala a /Applications si quieres tenerla a la mano.
CLI
bodega status espacio libre y cuánto se puede recuperar
bodega plan [--fresh] el plan de limpieza con sus IDs
bodega apply [--yes] aplica lo marcado por omisión, pidiendo confirmación
bodega ports puertos abiertos y qué proyecto los abrió
bodega stop <puerto> detiene el proceso de ese puerto
bodega mcp servidor MCP para Claude CodeCon Claude Code
claude mcp add bodega -- bodega mcpLuego pídele, por ejemplo, "¿qué me está llenando el disco?", "arma un plan para liberar 30 GB sin tocar los proyectos activos" o "¿qué está escuchando en el 5173?". Las herramientas que modifican algo exigen confirmed: true, que Claude manda sólo después de preguntarte.
Ajustes
En el dashboard eliges qué carpetas son de proyectos (por omisión ~/Developer), cuántos días cuenta un proyecto como activo (14), con cuánto espacio libre te avisa (20 GB; 0 apaga los avisos) y cuál es tu disco externo. Todo se guarda en ~/.bodega/.
Desarrollo
npm run dev # servidor en 2633 con recarga + Vite en http://localhost:2634
npm test # pruebas del motor, del servidor y del MCP
npm run lint
npm run desktop:dev # la app de escritorio contra el motor en 2633
BODEGA_DEMO=1 BODEGA_PORT=2635 node src/cli/main.ts serve # datos ficticios, nada toca tu discoGuía de contribución en CONTRIBUTING.md.
English
Bodega is a local dashboard, CLI and MCP server to manage disk space on a macOS development machine: build artifacts and caches per ecosystem (Flutter, .NET, Node, Rust, Gradle, Xcode, Python), iOS simulators and Android emulators, listening ports per project, moving projects and caches to an external drive with verified copies, and an encrypted backup of signing keys and .env files. It runs on 127.0.0.1:2633 with a per-install token, and an optional Tauri menu bar app (built from source) opens the same dashboard in its own window and warns when the disk runs low. UI is in Spanish; contributions to translate it are welcome.
Licencia
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Work on your own computers from Claude or ChatGPT: run commands, edit and search files.
Use your Mac, Windows or Linux computer from ChatGPT, Claude or Codex: files, commands, documents.
Your own computer's files from ChatGPT or Claude: folder rules, confirmations and undo.
Find, read, create and edit Plainer files with Claude Code or Codex. Approve access in your browser.
Related MCP Servers
- AlicenseAqualityDmaintenanceAllows Claude to execute terminal commands on your computer and perform file system operations including surgical code editing with diff-based replacements.197MIT
- AlicenseAqualityBmaintenanceProvides Claude Desktop with direct access to your local file system for development tasks, enabling file operations (read, write, edit), directory browsing, command execution, and codebase search within a configured projects directory.6MIT
- AlicenseCqualityBmaintenanceEnables Claude Desktop to control a local host machine through shell, file, git, network, Docker, package, and system monitoring tools, with approval-gated destructive operations.1461MIT
- AlicenseNot gradedqualityCmaintenanceEnables Codex to manage macOS local and cloud storage by indexing files, planning moves or copies, executing them with SHA-256 verification, and requiring explicit confirmation before deleting local originals.MIT