Quick Start

# Install globally
npm install -g devmop

# See how much disk space you can recover
devmop usage

# Interactive cleanup — pick what to clean
devmop clean -i

# Clean everything, no questions asked
devmop clean --all

Features

• Plugin Architecture — Modular cleaners for Node.js, Docker, Git, Flutter, and System caches. Easy to extend.
• Cross-Platform — Runs natively on macOS, Linux, and Windows. No bash required.
• Disk Analyzer — Visual ASCII bar chart showing exactly how much space each category uses.
• Interactive Mode — Multi-select TUI to cherry-pick what to clean.
• Watch Mode — Monitors disk usage in the background and sends a native OS notification when a threshold is exceeded.
• Git Workspace Cleaner — GC, merged branch removal, stash clearing, and untracked file cleanup across all your repos.
• Dry Run — Preview every deletion before anything is touched.
• Configurable — Persistent settings via ~/.devmoprc.
• Scheduling — One-line crontab (Linux/macOS) or Task Scheduler (Windows) setup.

Commands

devmop clean — Run cleanup

devmop clean [targets] [options]

Targets

Options

Examples

devmop clean --all --dry-run     # Preview everything
devmop clean --node --docker     # Clean Node + Docker only
devmop clean --all --aggressive  # Deep clean everything
devmop clean -i                  # Pick interactively

devmop usage — Disk usage breakdown

devmop usage

Scans all plugins and renders an ASCII bar chart:

Disk Usage Breakdown:
═══════════════════════════════════════════════════════════
node    [████████░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░]   3.2 GB
system  [████████████████████████████████████████]  12.1 GB
docker  [██░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░] 800.0 MB
flutter [█░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░] 420.0 MB
git     [░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░] 120.0 MB
═══════════════════════════════════════════════════════════
Total Recoverable: 16.64 GB

devmop git — Git workspace manager

devmop git [options]

Examples

devmop git --analyze            # See stats across all repos
devmop git --dry-run            # Preview what would change
devmop git --branches --gc      # Remove merged branches + GC
devmop git --aggressive         # Full deep clean

--analyze output

Git Repository Analysis (31 repos)

Repo                              Branches  Merged  Stash   Git Size
----------------------------------------------------------------------
projects/my-app                         18       9      1    2.23 MB
projects/another-project                 3       2      0     857 kB
tools/sqlmap                             1       0      0    89.9 MB
----------------------------------------------------------------------
Total                                   31      19           521 MB

devmop watch — Disk usage monitor

devmop watch [options]

Runs in the foreground, checking disk usage on a set interval. Sends a native OS notification (macOS Notification Center, Linux notify-send, Windows toast) when the threshold is exceeded.

Examples

devmop watch                              # Default: 1gb threshold, check every 30m
devmop watch --threshold 5gb             # Alert above 5 GB
devmop watch --threshold 2gb --interval 1h
devmop watch --threshold 500mb --auto-clean  # Auto-clean when exceeded

devmop schedule — Set up automatic cleanup

devmop schedule [--weekly | --monthly]

Prints a ready-to-use cron expression (macOS/Linux) or schtasks command (Windows).

devmop schedule --weekly   # Every Sunday at midnight
devmop schedule --monthly  # First of every month

Cross-Platform Support

devmop automatically detects the OS and adapts — no configuration needed.

Plugin System

Each cleaner is a plugin that extends BasePlugin:

// lib/plugins/my-plugin.js
import { BasePlugin } from "../base-plugin.js";

export class MyPlugin extends BasePlugin {
  constructor() {
    super("myplugin", "Clean my tool's cache");
  }

  async getSize() { /* return bytes */ }
  async clean({ dry, aggressive }) { /* perform cleanup */ }
}

Register it in lib/plugin-manager.js:

import { MyPlugin } from "./plugins/my-plugin.js";
this.register(new MyPlugin());

Configuration

devmop reads ~/.devmoprc on startup:

{
  "defaults": {
    "aggressive": false
  },
  "plugins": {}
}

Benchmarks

Contributing

Contributions welcome! Great first plugins to add: Python (__pycache__, .venv), Rust (target/), Go (~/go/pkg/mod), Gradle (.gradle/, build/).

git clone https://github.com/mertcanureten/devmop
cd devmop
npm install
node bin/devclean.js --help

License

MIT © Mertcan Ureten