sasurahime 0.1.13

macOS developer cache cleaner — scan and wipe stale caches from 40+ tools
sasurahime-0.1.13 is not a library.

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)
sasurahime scan

# List all supported clean targets
sasurahime targets

# Show version
sasurahime --version

# Clean everything interactively
sasurahime

# Clean specific targets
sasurahime clean uv
sasurahime clean brew
sasurahime clean mise
sasurahime clean browsers
sasurahime clean xcode
sasurahime clean caches          # bun / go / pip / node-gyp / npm / yarn / pnpm
sasurahime clean logs

# Preview without deleting
sasurahime clean uv --dry-run

# Non-interactive (CI / scripting)
sasurahime --yes

# Permanently delete (bypass Trash)
sasurahime clean uv --permanent

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 --permanent to permanently delete.
  • mise runtime removal checks both global and per-project .mise.toml before 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 HOWTO-ADD-target.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

サイズについて: 上記の数値は開発者一人の環境での実測値です。 環境によって大きく異なります。目安としてご覧ください。

使い方

# スキャンして一覧表示(削除しない)
sasurahime scan

# 対応している削除対象を一覧表示
sasurahime targets

# バージョン表示
sasurahime --version

# インタラクティブに選択して削除
sasurahime

# 対象を指定して削除
sasurahime clean uv
sasurahime clean brew
sasurahime clean mise
sasurahime clean browsers
sasurahime clean xcode
sasurahime clean caches          # bun / go / pip / node-gyp / npm / yarn / pnpm
sasurahime clean logs

# 削除せずに確認だけ(dry-run)
sasurahime clean uv --dry-run
sasurahime scan --dry-run

# 確認なしで全削除(CI・スクリプト向け)
sasurahime --yes

# 完全削除(ゴミ箱を経由しない)
sasurahime clean uv --permanent

安全性について

  • すべてのクリーナーは --dry-run に対応しています。確認するまで何も削除しません。
  • Trash モードがデフォルトで有効です。削除したファイルは macOS のゴミ箱に移動されるため、Finder から復元できます。完全に消去したい場合は --permanent フラグを使用してください。
  • mise のランタイム削除は、グローバル設定とプロジェクト固有の .mise.toml を両方チェックしてから実行します。
  • macOS の immutable フラグ(uchg)は自動的に解除してから削除します。

名前の由来

**速佐須良比売(ハヤサスラヒメ)**は、神道の「大祓詞」に登場する祓戸の女神です。

神話の世界では、世界中から集まった罪や穢れは川から海へ、そして海の底へと流れていきます。その最後の最後に待ち受けて、すべてを根の国・底の国へ持ち去り、跡形もなく消し去るのがハヤサスラヒメです。

究極のデストラクタ。

コマンド名としての音の響き、そして「溜まった不要なものを完全に消し去る」という役割 — 『古事記』『日本書紀』の神々の中から、このツールにぴったりの名を選びました。

ライセンス

Apache-2.0

コントリビュート

Issue・PR ともに歓迎します。詳細は HOWTO-ADD-target.md をご覧ください。

機能の提案はコードを書く前に Issue を立てて相談してください。