An unofficial macOS graphical client for Mole CLI, with more approachable workflows built on its capabilities. Keep it simple: see the result, understand the impact, then choose the next action. Built with React + Vite + TypeScript + Tauri + SQLite.
This independent, unofficial project is for learning and research only. Understand the effects of each operation and back up important data before use. You assume the risks and any resulting issues.
Some features build on Mole CLI. Thanks to its author and contributors. Please respect and support their work by choosing the official Mole product for everyday use.
Current interface in Simplified Chinese, captured from the browser preview with sample data. These images do not represent a scan of this Mac or release acceptance. Click an image to view it at full size.
| Space analyzer | Cleanup review |
|---|---|
 |
 |
| System maintenance | System status · Dark theme |
 |
 |
Brand assets: SVG icon · Logo · Logo for dark backgrounds. See usage notes.
The interface supports Simplified Chinese, English and Japanese. Switch at any time in Settings → General → Interface language, without restarting. First launch follows the system’s primary preferred language; other system languages fall back to English. Manual choices are saved locally across restarts, and you can return to Follow system. Paths, original logs and diagnostic evidence retain their original text. Detailed development documents are currently mainly in Chinese.
Latest published version: 0.2.0 (2026-10-29), bundled with Mole CLI 1.65.0. This learning and research release includes real cleanup, app uninstall and Quick Look maintenance within the limits below. Full permission/fault, installation/upgrade and corresponding-source/license acceptance remains incomplete; see execution acceptance and the release notes.
New in 0.2.0: quick cleanup with verified user-cache execution, AI deep scan through local agents, Chinese/English/Japanese switching, restored window dragging and restrained task animations. The release notes are available in English, Simplified Chinese and Japanese.
| Feature | Available now | Current limits |
|---|---|---|
| Quick cleanup / Cleanup | Summarizes caches, logs, uninstall remnants, large files and apps. Checked help/icon caches are selected by default; eligible user caches and ordinary logs can be moved to Trash after confirmation. | Only clearly sourced user-cache ordinary files/strict folders and ordinary logs. Remnants and personal large files cannot be processed yet. Unknown, changed or expired items are retained. See quick cleanup. |
| AI deep scan | Detects local agents and uses a built-in skill, Mole candidates, selected-folder metadata and model knowledge for item suggestions, then enters existing cleanup review. | Initially Codex CLI / Claude Code (Claude needs API/provider credentials; live validation pending). Model data use and quota require confirmation. Extended findings are for verification only. See AI scan. |
| Applications | Search apps, inspect running/associated clues, and confirm moving one supported ordinary app bundle to Trash. | Settings, caches and personal data outside the bundle remain. Running, protected, managed or uncertain apps are retained; no promise to remove all remnants. |
| Maintenance | Browse 19 pinned Mole task descriptions; explicitly choose and execute two-step Quick Look thumbnail-cache and generator-list refresh. | Other tasks are read only. No original-cache backup or one-click undo; no repair or speed guarantee. |
| Space analyzer | Choose folders, view maps/lists, drill down, navigate clickable paths, filter large files and reveal in Finder. | No deletion. Measured sizes are not reclaimable space; incomplete results are labelled. |
| System status | Snapshots, pausable continuous collection, CPU/memory/disk/network trends and available metrics. | Missing or stale metrics are identified. Leaving stops continuous collection. |
| Project artifacts / Installers | Explicit scope selection, discovery, measurement, filtering and read-only checks. | No cleanup yet. No detected usage is not proof of eligibility. |
| Activity history | Item results, receipts, interrupted/unverified states, complete archiving, export and read-only opening. Verification preserves original facts. | No re-execution from history or automatic in-app recovery. Archives still consume disk space. |
Start with first use. See product direction and release roadmap for the full capability map and remaining scope. The home page shows the actual bundled Mole CLI version and engine state. Browser previews use sample data only.
Moving to Trash does not immediately free space. Cancellation stops only work not yet started; existing outcomes remain. Unverified results are not retried automatically. To retrieve an item, verify the real object and original folder in Finder and avoid overwriting existing files. Client protection and Mole allowlists remain in force; unknown or restricted conditions are never relaxed to obtain success.
Download the architecture-matched 0.2.0 DMG below. Packages use free ad-hoc signing; they do not have Apple Developer ID signing or notarization. A paid Apple developer account is not required.
| Mac | Download |
|---|---|
Apple Silicon (arm64) |
MooMole 0.2.0 DMG |
Intel (x64) |
MooMole 0.2.0 DMG |
Check the chip/processor in About This Mac. Verify file size and SHA-512 on the release page or against SHA512SUMS, open the DMG, copy the app to Applications, then launch from that location. Matching source, dependency materials and validation manifests are in each architecture’s materials.zip on the release page.
On first open, macOS may warn that the developer or malicious-software status cannot be verified. Confirm the source and integrity, then decide using Apple’s security guidance. The app never disables Gatekeeper or strips system security attributes. Updates follow Settings → About → Check for updates → Download and verify size/SHA-512 → Open DMG → Quit normally and replace manually. A running app is never silently replaced. Checking does not generate packages when no new release exists.
The 0.2.0 packages passed automated checks on macOS arm64 and x64, nested-signature/resource checks, DMG mounting and public-download checksum verification; see the release validation record. Native Intel interaction, first open after a quarantined public download, cross-version installation/permission behavior and full supported-environment acceptance remain pending. See distribution.
Build target: macOS 14+. Actual native interaction acceptance has mainly used an Apple Silicon development Mac; the target does not establish minimum-OS or Intel acceptance.
Requires Node.js 24+, npm, Rust, Go and Xcode Command Line Tools. Pinned versions are in build validation. Scripts prefer toolchains in project .cache/ without changing shell configuration. A fresh clone still needs tool setup.
npm ci
npm run engine:prepare
npm run desktop
# Browser samples only; no local data access
npm run dev
# Build a local optimized App, ZIP and verification report; no upload/publication
npm run build:local-app
# Also create, mount, verify and eject an architecture-matched ad-hoc DMG
npm run build:local-dmgThe engine is built from a pinned Git tree, checked for resources/architecture and published atomically. Failure retains the old engine. With caches present, append -- --offline to preparation/local-artifact commands. Running the app needs no development toolchain and never downloads or separately updates its bundled engine. See engine preparation and local builds.
Edit the app version only in package.json, then run npm run version:sync to synchronize native and lock files. Common checks:
npm run version:check
npm run format:check
npm test
npm run build
npm run notices:prepare # Prepare licensing materials before native builds; Tauri wrapper does this automatically
npm run check:rust
npm run test:engine
npm run test:adapter
npx playwright install chromium
npm run test:e2eBrowser regression uses a separate port 1431 without reusing an existing server; override with MOOMOLE_E2E_PORT=1432 if occupied. Development app uses 1420. Other version/artifact/source/licensing/candidate checks are in build validation. Checks run independently of releases. As in MooTool, pushing a version tag starts parallel packaging, publishes the trilingual GitHub Release, then updates the feed and README download blocks automatically. See release conventions.
Settings and records live in ~/Library/Application Support/io.github.rememberber.moomole/, with database moomole.sqlite. Records may contain paths, check results, operation intent and Trash receipts, never file contents or administrator passwords. AI deep scans separately ask permission to send bounded file metadata to the chosen agent’s model service; other records are not uploaded automatically.
Task, scan and review history defaults to 30 days, with 7/90-day options. Execution evidence and unverified interruption evidence are not pruned with ordinary history. All three execution modules share admission and active-record limits. When full, new batches stop. In Activity history → Archive…, save complete records that have ended and received required review to free active capacity. Archives preserve original plans, results, receipts, events and verification marks, support export/read-only opening, and never restore execution permission. See retention and execution archives.
Current database schema: v7. Upgrades from v1–v6 back up automatically; older apps should not open the new database directly. Interrupted changes do not resume automatically. Verify actual objects before recording verification of uncertain results; original unknown outcomes are not rewritten. No one-click database rollback or universal undo. See upgrade and recovery.
The frontend exposes no general shell, arbitrary SQL or direct filesystem interface. Changes use separate log/uninstall/Quick Look confirmation and per-run validation. Updates access fixed sources without sending folders, history or diagnostics; see update privacy and protocol. Read-only checks may write local caches/check records; they do not imply zero local writes.
Bundled Mole CLI baseline: 1.65.0 / 308bf9911179ddfa40e5df9fdc42095a18ba5cfc. Upstream sources are unchanged. Client adapters and UI sources are in this repository. Release materials provide the client, Mole, published dependencies and npm source inputs bound to the same app. Complete corresponding-source and release-license review remain pending; see source bundles and dependency materials.
Licensed under GPL-3.0-only. See Mole-LICENSE and third-party notices for upstream licensing, provenance and build details. Mole names and brand assets belong to the original project. This project is neither official nor endorsed; the public name still requires confirmation under upstream branding policy.