Quick Start

First scan

Point fialr at any directory to build a manifest:

fialr scan ~/Documents

fialr traverses the directory, computes BLAKE3 and SHA256 hashes for every file, detects MIME types, and generates a structured manifest. No files are modified. This is a read-only operation.

The output shows file count, total size, and extension distribution.

Classify

Run classification to assign sensitivity tiers and suggest categories:

fialr classify ~/Documents

Every file receives a sensitivity tier (1: RESTRICTED, 2: SENSITIVE, 3: INTERNAL) based on structural signals — filename patterns, extensions, and directory heuristics. Tier 1 files are never processed by AI. They are flagged for manual review.

Plan

Generate a dry-run reorganization plan:

fialr plan ~/Documents

This produces a plan.csv with proposed moves and renames. Review it before executing. No files move until you explicitly approve.

Next steps

• Read Infrastructure, Not Organizer to understand the design philosophy
• Learn about sensitivity tiers and how files are classified
• See the full CLI reference for all commands and options