Kirei

Overview

Kirei (きれい - "clean" or "beautiful" in Japanese) is a fast, safe, and beautiful macOS system cleaner built in Rust. It helps developers reclaim disk space by identifying and removing cache files, build artifacts, and logs without destructive defaults.

Key Features

• Developer-Focused: Deep cleaning for Xcode, Node/Bun, Cargo, and user logs
• Interactive TUI: Beautiful terminal interface with real-time visualization
• Safety First: All deletions move to Trash (fully recoverable), explicit user confirmation required
• Fast & Parallel: Asynchronous scanning powered by Tokio

Installation

From GitHub (Recommended)

Install directly from the GitHub repository:

cargo install --git https://github.com/ItamiForge/kirei.git

From Source

Clone and build locally:

git clone https://github.com/ItamiForge/kirei.git
cd kirei
cargo install --path .

Requirements

• macOS 10.15 (Catalina) or later
• Rust 1.70 or later

Quick Start

Launch the interactive TUI:

kirei

Or run a quick scan without entering interactive mode:

kirei scan

TUI Controls

• ↑/↓ or j/k - Navigate file list
• Space - Toggle selection for cleaning
• Tab - Switch between Dashboard and List view
• c - Clean selected items (moves to Trash)
• r - Rescan system
• q - Quit application

Safety Design

Kirei prioritizes safety:

1. Trash Integration: Files are moved to macOS Trash, not permanently deleted
2. Read-Only Scans: Scanning requires no permissions and modifies nothing
3. Explicit Confirmation: Manual selection and confirmation required for all deletions
4. No Automatic Operations: Never runs cleanup without user interaction

Project Links

Development Status

• CLI/TUI: Active and functional
• GUI (Tauri): Work in progress
• CLI Deletion: Intentionally not implemented - use TUI for safety