sasurahime
A macOS developer cache cleaner written in Rust.
sasurahime scans well-known cache locations — uv, Homebrew, mise runtimes, Playwright/Puppeteer browsers, bun, Go, pip, and more — shows you what's taking up space, and lets you choose what to remove. Safely.
$ sasurahime scan
Category Size Status
──────────────────────────────────────────
uv (archive) 18.2 GB pruneable
Homebrew downloads 16.6 GB stale
bun cache 5.5 GB clearable
mise / node (old) 3.4 GB unused
Playwright (old) 0.5 GB stale
──────────────────────────────────────────
Total reclaimable 44.2 GB
Note on sizes: The numbers above are from one developer's machine. Your environment will differ — these are examples, not guarantees.
Usage
# Scan and report (no deletion)
# List all supported clean targets
# Show version
# Clean everything interactively
# Clean specific targets
# Preview without deleting
# Non-interactive (CI / scripting)
# Permanently delete (bypass Trash)
Safety first
- Every cleaner supports
--dry-run— nothing is deleted until you confirm. - Trash mode is on by default — removed files go to macOS Trash, so you can
restore them from Finder. Use
--permanentto permanently delete. - mise runtime removal checks both global and per-project
.mise.tomlbefore deleting. - macOS immutable flags (
uchg) are handled automatically.
Name
sasurahime is named after 速佐須良比売（Hayasasurahi-me）, a goddess who appears in the Oharae-no-Kotoba (Great Purification Words) of Shinto tradition.
In Japanese mythology, impurities swept from the world are carried downstream — from river to sea, and finally to the depths of the underworld (Ne-no-Kuni). It is Hayasasurahi-me who receives them at the very end and makes them vanish without a trace.
She is, in other words, the ultimate destructor.
The name was chosen from the world of the Kojiki and Nihon Shoki for its role — purging accumulated impurities (stale caches, orphaned files) completely and finally — and for how cleanly it reads as a command name in a terminal.
License
Apache-2.0
Contributing
Issues and PRs are welcome. See CONTRIBUTING.md for details.
For feature proposals, please open an issue first so we can discuss the scope before diving into code.
macOS 開発者向けキャッシュクリーナー（Rust 製）。
uv・Homebrew・mise のランタイム・Playwright/Puppeteer のブラウザバイナリ・bun・Go・pip など、開発ツールが積み上げたキャッシュをスキャンし、何がどれだけ使っているかを表示したうえで、選択して削除できます。安全に。
$ sasurahime scan
Category Size Status
──────────────────────────────────────────
uv (archive) 18.2 GB pruneable
Homebrew downloads 16.6 GB stale
bun cache 5.5 GB clearable
mise / node (old) 3.4 GB unused
Playwright (old) 0.5 GB stale
──────────────────────────────────────────
Total reclaimable 44.2 GB
サイズについて: 上記の数値は開発者一人の環境での実測値です。 環境によって大きく異なります。目安としてご覧ください。
使い方
# スキャンして一覧表示（削除しない）
# 対応している削除対象を一覧表示
# バージョン表示
# インタラクティブに選択して削除
# 対象を指定して削除
# 削除せずに確認だけ（dry-run）
# 確認なしで全削除（CI・スクリプト向け）
# 完全削除（ゴミ箱を経由しない）
安全性について
- すべてのクリーナーは
--dry-runに対応しています。確認するまで何も削除しません。 - Trash モードがデフォルトで有効です。削除したファイルは macOS のゴミ箱に移動されるため、Finder から復元できます。完全に消去したい場合は
--permanentフラグを使用してください。 - mise のランタイム削除は、グローバル設定とプロジェクト固有の
.mise.tomlを両方チェックしてから実行します。 - macOS の immutable フラグ（
uchg）は自動的に解除してから削除します。
名前の由来
**速佐須良比売（ハヤサスラヒメ）**は、神道の「大祓詞」に登場する祓戸の女神です。
神話の世界では、世界中から集まった罪や穢れは川から海へ、そして海の底へと流れていきます。その最後の最後に待ち受けて、すべてを根の国・底の国へ持ち去り、跡形もなく消し去るのがハヤサスラヒメです。
究極のデストラクタ。
コマンド名としての音の響き、そして「溜まった不要なものを完全に消し去る」という役割 — 『古事記』『日本書紀』の神々の中から、このツールにぴったりの名を選びました。
ライセンス
Apache-2.0
コントリビュート
Issue・PR ともに歓迎します。詳細は CONTRIBUTING.md をご覧ください。
機能の提案はコードを書く前に Issue を立てて相談してください。