devmop

Mop up the junk that silently eats your disk.

node_modules, Docker images, git garbage, Flutter caches, system temp files —
devmop finds them all and wipes them clean, on any OS.

🖥 Terminal Dashboard (TUI) — New in v1.1.0!

devmop now features a beautiful, full-screen interactive dashboard (inspired by htop). No more guessing — see your disk usage in real-time and clean it with a single keystroke.

Launch it with just:

devmop
# or
devmop dashboard

Dashboard Features:

• ASCII Bar Charts — Visual representation of disk usage per category.
• Interactive Sidebar — Navigate through plugins with arrow keys.
• Instant Cleanup — Press C to clean selected plugin or A for everything.
• Alternate Buffer — Stays in the dashboard, leaves your terminal scroll-back clean.

Quick Start

# Install globally
npm install -g devmop

# Launch the Dashboard (Recommended)
devmop

# Classic CLI usage
devmop usage           # Detailed size breakdown
devmop clean -i        # Interactive menu clean
devmop clean --system  # Immediate system cleanup

Features

• Terminal Dashboard (TUI) — A premium, full-screen interactive experience.
• Plugin Architecture — Modular cleaners for Node.js, Docker, Git, Flutter, and System caches.
• Cross-Platform — Native support for macOS, Linux, and Windows.
• Disk Analyzer — Stylish ASCII charts showing space recovered.
• Watch Mode — Background monitoring with native OS notifications.
• Git Workspace Cleaner — Deep-clean branches, GC, and more across all local repos.
• Safety First — Robust permission handling and dry-run support.

Commands

devmop dashboard (or simply devmop)

Launches the interactive TUI. Use it to navigate and clean categories visually.

Shortcuts inside Dashboard:

• ↑ / ↓ — Navigate categories
• C — Clean selected plugin
• A — Clean ALL categories
• Q — Quits the dashboard

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/devmop.js --help

License

MIT © Mertcan Ureten