CleanFlow：先预览再执行的本地文件清理工具，支持 Claude 与 Ollama 分类

🇩🇪 Deutsche Version

Shows you the whole cleanup before it touches anything, and remembers what it did.

Point it at Downloads or Desktop. CleanFlow applies its rules, finds the duplicates and the junk, and hands you a plan: every move, every deletion, every tag, listed. You tick what should happen. Every executed action goes into a journal: moves and renames can be undone from the app, and whatever went to the Trash comes back with Finder's Put Back.

Not for you if the filenames tell you nothing and you need something to look inside the files, including photos. That is a different job, and LifeSort is the one in this portfolio: it reads documents and runs a vision model over images to sort by content. CleanFlow works by rule, which is faster and predictable, but a rule cannot tell you what is in IMG_4471.jpg.

Nothing is executed until you select it, and the AI only suggests.

How it runs: CleanFlow is a native desktop app, not a server or browser tool. It opens as its own window and has no tray icon or background service; it only runs while the window is open.

💾 Download: macOS (DMG) · Windows (Installer) · Linux (AppImage): always the latest release, not code-signed/notarized (Gatekeeper/SmartScreen will warn on first run). Or build from source, see Getting Started below.

In practice: you scan a folder, review a generated plan of moves, trashes and tags, and execute only what you select; every run is kept in a journal, moves and renames can be undone from it, and trashed files come back with Finder's Put Back. AI (Claude or a local Ollama model) only assists with classification and suggestions; the underlying scan, rule matching, and undo logic works without it.

🌱 New here? → Step-by-step guide for beginners

Features

Requirements

• Rust 1.77+
• Node.js 20+
• Tauri CLI v2: cargo install tauri-cli
• macOS / Windows / Linux (Tauri v2)

Quick Start

git clone https://github.com/9t29zhmwdh-coder/CleanFlow
cd CleanFlow

# Install frontend dependencies
cd frontend && npm install && cd ..

# Run in development mode
cargo tauri dev

# Build release
cargo tauri build

CLI Only

cargo install --path crates/cf-cli

cleanflow scan ~/Downloads
cleanflow organize ~/Downloads --execute
cleanflow undo
cleanflow rules list

Uninstall / Cleanup

CleanFlow is a self-contained app with no installer and no background service.

• macOS: delete the app bundle, then remove ~/.cleanflow/ (settings, scan journal).
• Windows: remove the app folder, then delete %USERPROFILE%\.cleanflow\.
• API keys are stored in the OS keychain, not in ~/.cleanflow/; remove them separately via Keychain Access (macOS) or Credential Manager (Windows) if you added one.
• CleanFlow never touches your original files outside the folders you explicitly scan and organize; there is nothing else to clean up.

AI Providers

Cost: ~$0.002 per 1,000 files with claude-haiku-4-5.

Built-in Rules

Architecture

CleanFlow/
├── crates/cf-core/      # Rust: scanner, AI, rules, planner, executor, undo
├── crates/cf-cli/       # CLI binary (clap)
├── src-tauri/           # Tauri v2 backend + IPC commands
└── frontend/            # React + TypeScript + Tailwind

Author: Rafael Yilmaz · Status: Active · · License: MIT