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, classifies by sensitivity tier, and records everything in the database. No files are modified. This is a read-only operation.

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

Process

Run the full pipeline in one command:

fialr process ~/Documents

This runs scan, classify, enrich, and rename in sequence — all in dry-run mode. Review the YAML plan, then execute:

fialr process ~/Documents --execute --reviewed

Organize

Move enriched files into schema directories:

fialr organize ~/Documents

This produces a move plan based on enrichment metadata and your schema.yaml. Review it, then execute with --execute --reviewed. 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
• Enrich files with AI-generated metadata, then search by keyword or semantic similarity
• See the full CLI reference for all commands and options