CacheBar

A lightweight macOS menu bar utility for real-time system monitoring and safe cache cleanup.
Built with Tauri 2 (Rust) + React + Tailwind CSS.

Click the menu bar icon to open a rounded, translucent panel: Overview shows CPU, disk, memory, network, and top processes; Cleanup scans categorized safe-to-remove caches with review before delete.

Features

• Menu bar panel — tray icon toggles a frameless panel; auto-hides on focus loss (disabled during scan/delete and while modals are open).
• Overview
  • CPU — brand string, live stacked area chart (User / System / Idle), total usage %.
  • Disk — root volume Used / Total, usage bar, live read/write rates (APFS-aware used space).
  • Memory — used / total / available / cached; Free Up runs optimize tasks.
  • Network — live ↓ / ↑ throughput, active IP and interface.
  • Top processes — top 5 by CPU % with bar indicators.
• Cleanup — mole-style sections and categories (safe / review), expandable items, multi-select, sticky delete bar, post-clean summary.
• Bottom menu — Refresh (⌘R), Settings… (⌘,), About CacheBar, Quit (⌘Q).
• Settings — refresh interval (persisted in localStorage).
• Safety — destructive actions require confirmation; cache paths are scanned first for review.

Install (macOS)

Requires macOS 11+ on Apple Silicon (arm64) for the pre-built DMG. Intel Macs need a separate build; see Building a DMG.

Homebrew (tap)

Tap repo: ingeniousfrog/homebrew-tap

brew tap ingeniousfrog/tap
brew install --cask cachebar

After each release, update the tap’s Casks/cachebar.rb (version, sha256) — see homebrew-tap/README.md and docs/RELEASE.md.

One-line install script

Downloads the DMG from GitHub Releases and installs CacheBar.app to /Applications:

curl -fsSL https://raw.githubusercontent.com/ingeniousfrog/CacheBar/main/scripts/install.sh | bash

Pin a version: CACHEBAR_VERSION=0.1.0 curl -fsSL https://raw.githubusercontent.com/ingeniousfrog/CacheBar/main/scripts/install.sh | bash
Or run locally: bash scripts/install.sh

Download DMG manually

GitHub Releases (used by the script and Homebrew cask):

• Releases → download CacheBar_0.1.0_aarch64.dmg (or the latest asset for your version).

Baidu Netdisk (mirror):

Link	https://pan.baidu.com/s/1s698O2B0GMjsj70nlVKhfA?pwd=frog
提取码	frog

Steps

1. Download the DMG (GitHub or Baidu).
2. Double-click the DMG, then drag CacheBar.app into Applications.
3. First launch — if macOS shows an unidentified-developer warning:
   • Open System Settings → Privacy & Security, click Open Anyway, or
   • Right-click CacheBar.app in Applications → Open.
4. Click the CacheBar icon in the menu bar to show or hide the panel.

Maintainers: upload each DMG to GitHub Releases before users run the install script or Homebrew cask. See docs/RELEASE.md.

Build from source

git clone https://github.com/ingeniousfrog/CacheBar.git
cd CacheBar
npm install
npm run tauri dev

npm run tauri dev starts Vite and the Tauri shell. Use the tray icon to toggle the panel.

Requirements

• macOS 11+ (Apple Silicon recommended for the pre-built DMG)
• Node.js 18+ and npm (development only)
• Rust stable + Xcode Command Line Tools (xcode-select --install) (development only)

Useful scripts

Command	What it does
npm run dev	Vite dev server only (UI in browser).
npm run build	Type-check and build the React bundle to dist/.
npm run tauri dev	Hot-reload Tauri app + Vite.
npm run tauri build	Release binary and installers.

Keyboard shortcuts

Shortcut	Action
⌘R	Refresh status
⌘,	Open Settings
⌘Q	Quit CacheBar

Architecture

+-----------------------------+         +--------------------------+
|        React + Vite         |  invoke |        Tauri (Rust)      |
|  src/App.tsx                |<------->|  src-tauri/src/main.rs   |
|  - Overview / Cleanup tabs  |         |  - tray + window toggle  |
|  - CPU history (60 samples) |         |  - command bindings      |
+--------------+--------------+         +-----------+--------------+
               ^                                    |
               |  status / clean / …                v
               +--------------------------+  src-tauri/src/core/
                                          status.rs, clean.rs, …

Backend highlights (src-tauri/src/core/)

• status.rs — CPU (top), RAM (sysctl / vm_stat), disk (df + iostat), network (netstat), top processes; stateful rate sampling.
• clean.rs — categorized scan (CleanScanResult), safe path whitelist, APFS snapshot handling.
• optimize.rs — maintenance tasks (e.g. cache purge).
• tray_icon.rs — rounded menu-bar tray icon generation.

Building a DMG

npm install
npm run tauri build -- --bundles dmg

First release build may take several minutes. Output (typical paths):

• src-tauri/target/release/bundle/dmg/CacheBar_0.1.0_aarch64.dmg
• src-tauri/target/release/bundle/macos/CacheBar.app

Universal binary (x86_64 + aarch64):

rustup target add x86_64-apple-darwin aarch64-apple-darwin
npm run tauri build -- --target universal-apple-darwin --bundles dmg

For distribution outside personal use, sign and notarize the .app before sharing the DMG.

Project layout

CacheBar/
├── src/
│   ├── App.tsx           # UI (Overview, Cleanup, modals)
│   ├── main.tsx
│   └── styles.css
├── src-tauri/
│   ├── icons/icon.png    # App & tray source icon (shown above)
│   ├── tauri.conf.json
│   └── src/
│       ├── main.rs
│       ├── tray_icon.rs
│       └── core/
└── README.md

License

MIT — see LICENSE.