MangoDisk

English · 简体中文 · 繁體中文 · 日本語

What MangoDisk Can Do

Deep Cleanup

Deep Cleanup is MangoDisk's core feature. It scans caches, temporary files, and rebuildable content from the system, applications, developer tools, and local projects, then groups the results to show reclaimable space:

• System and user caches: Clean system temporary files, diagnostic data, and rebuildable caches stored in user directories.
• Application caches: Clean caches, logs, update packages, and temporary content created by commonly used applications.
• Browser data: Clean caches and temporary web data created by Chrome, Edge, Firefox, Brave, Arc, Opera, and other browsers.
• Developer tools and Xcode: Clean package manager downloads, IDE indexes, compiler caches, and device support, archives, and development data generated by Xcode.
• Container caches: Clean unused build caches and rebuildable temporary data created by Docker and other container tools.
• Project build artifacts: Find rebuildable dependencies, caches, and build directories in Node.js, Rust, Gradle, Swift, Python, .NET, Godot, CMake, and other projects.
• AI models and caches: Find local AI models, download caches, and temporary transfer files to identify model data that consumes significant storage.
• Application optimization: Remove processor code the current device does not need from supported applications, reducing storage use without affecting normal operation.

Scanning only reads file information and never deletes anything automatically. Use smart recommendations or review items individually, then check the estimated reclaimable space before cleaning.

Large File Cleanup

Quickly find files using the most space on a disk or in a selected folder, then browse them by type and size. Review each file and its location before deciding whether to delete it.

Duplicate File Cleanup

Find exact duplicates by file content instead of relying on file names. Results show the number of copies, size of each file, and maximum reclaimable space for each group. Smart selection keeps at least one file in every group.

Application Uninstall and Cleanup

Review installed applications, their sizes, running status, and associated files. Before uninstalling, inspect caches, settings, and leftover data, with rebuildable content separated from data that may include personal files. MangoDisk also warns you when an application is running or protected by the system.

Startup Item Management

Review and manage programs that start automatically on macOS and Windows. Turning off unnecessary startup items can help reduce startup or sign-in delays and background resource usage, and you can turn them back on whenever needed.

Disk Space Analysis

Use a treemap and list view to understand storage distribution on a disk or in a selected folder. Browse the hierarchy to find the largest directories and files, then open their locations directly.

Operation History

Review cleanup, file deletion, application uninstall, and startup item changes, including their results and reclaimed space, so you can confirm what happened in each operation.

Safety Design and Cleanup Rules

MangoDisk scans in read-only mode by default. Before cleaning, permanently deleting files, uninstalling applications, or changing startup items, it shows the expected impact and asks for confirmation. Afterward, you can review the result in Operation History.

MangoDisk maintains its own cross-platform cleanup rule library instead of copying rules directly from third-party projects. Windows rules may use Winapp2.ini to identify candidate paths, while macOS rules may draw on relevant open source projects. These sources provide research leads only and are never sufficient on their own to justify cleaning a path.

Before a candidate rule can ship in a release, it must pass the following checks:

• Verify authoritative sources: Confirm the path's purpose and data ownership using documentation from Microsoft, Apple, or the software vendor.
• Define safe cleanup boundaries: Ensure the content can be safely recreated, and exclude personal files, private application data, and protected system paths.
• Validate on real systems: Test the paths, cleanup results, and failure scenarios in the appropriate Windows or macOS environment.

Only rules that pass source verification, safety review, and hands-on testing are added to the production rule library. In short: third-party projects provide leads, but official evidence and real-world testing determine whether a rule is accepted.

The complete rule library is public, so every rule and revision can be inspected and traced: view the MangoDisk cleanup rule library.

MangoDisk always puts data safety ahead of reclaiming more space. Content without clearly verified safety boundaries is excluded from production rules, and users can review and confirm selected items before anything is removed.

Screenshots

Deep Cleanup
_{Scan cleanable content across the system, applications, developer tools, and projects, then review it before cleaning}

Large File Cleanup Find large files by type and size, then review them before cleaning	Duplicate File Cleanup Find exact duplicates by content while keeping at least one copy
Application Uninstall and Cleanup Uninstall applications and review their caches, settings, and private data	Startup Item Management Review and manage programs that run automatically when your system starts or you sign in
Disk Space Analysis Use treemap and list views to find the content taking up the most space

Install and Run

Install MangoDisk on macOS with Homebrew:

brew install --cask harry0703/tap/mangodisk

Alternatively, download the latest version from the MangoDisk website or GitHub Releases:

• macOS: Open the DMG and drag MangoDisk into the Applications folder.
• Windows: Run the Windows installer and follow the prompts.

Important

Cleanup, permanent deletion, and uninstall operations may be irreversible. Review the selected content and keep reliable backups of important data. Before changing a startup item, make sure you understand what the program does.

CLI Quick Start

Install the standalone CLI on macOS with Homebrew:

brew install harry0703/tap/mangodisk-cli

Homebrew adds mangodisk to your command path. Open a new terminal if the command is not immediately available, then verify the installation:

mangodisk --version

The CLI uses the same safety-first cleanup engine as the desktop application. Use commands such as:

# Scan and show cleanable content without changing anything
mangodisk clean

# Apply the same smart recommendations as the desktop application
mangodisk clean --apply

# Preview all selectable content without deleting anything
mangodisk clean --apply --selection all --dry-run

# Produce machine-readable JSON output
mangodisk clean --format json --no-progress

mangodisk clean only scans and never modifies files by default. To perform cleanup in a non-interactive environment, you must also pass --yes to confirm explicitly. Run the following command for all available options:

mangodisk clean --help

Build from Source

Prerequisites

• Node.js 24 LTS
• pnpm 11.13.1
• Stable Rust
• macOS: Xcode Command Line Tools
• Windows: Visual Studio 2022 Build Tools with Desktop development with C++
• Windows: Microsoft Edge WebView2 Runtime

See the Tauri 2 prerequisites for detailed platform requirements.

Get the Source and Run the Desktop Application

git clone https://github.com/harry0703/MangoDisk.git
cd MangoDisk
pnpm install --frozen-lockfile
pnpm tauri:dev

Run the Required Checks

pnpm check
cargo test --manifest-path src-tauri/Cargo.toml -p mangodisk-core

Build the Desktop Installer

pnpm tauri:build

Build the CLI

pnpm cli:build

Local builds do not include the signing, notarization, or update metadata provided by official MangoDisk releases. Use them for local development and validation only.

Contributing

Issues, cleanup rules, fixes, and new features are welcome. Read CONTRIBUTING.md and AGENTS.md before getting started.

Routine cleanup coverage should use build-validated, declarative TOML rules. See src-tauri/crates/mangodisk-core/rules/README.md for the rule schema, safety constraints, and validation instructions.

Before submitting changes, run at least:

pnpm check
cargo test --manifest-path src-tauri/Cargo.toml -p mangodisk-core

Report security vulnerabilities privately through GitHub Security Advisories as described in SECURITY.md. Do not open a public issue for a security vulnerability.

Technology Stack

• Tauri 2: Desktop runtime and system integration
• Rust: Scanning, filesystem access, safety validation, and cleanup execution
• Vue 3 and TypeScript: Desktop user interface

License

MangoDisk is open source under the GNU General Public License v3.0. Third-party components remain subject to their respective licenses.