01
Inventory without interpretation
Discover files, capture filesystem identity, and probe media metadata before deciding what any relationship means.
v0.1 · read-only by design
Know what is actually on disk.
OptiFlow observes media, proves exact relationships, and produces review-only optimization plans—without changing your source files.
Open source · macOS and Linux · machine-readable contracts
$
optiflow scan ~/Media
- 01 discoverenumerate candidates complete
- 02 observecollect stable facts complete
- 03 provehash exact content verifying
- 04 planemit review artifact waiting
01 Evidence before inference
02 Exact means byte-for-byte
03 Plans never mutate sources
Evidence pipeline
From a directory to a defensible decision.
Every conclusion is traceable to durable observations. Coverage, uncertainty, and interruption are first-class outcomes—not details hidden behind a success message.
Prove exact relationships
Candidate groups become exact duplicates only after compatible evidence and full-content hashing agree.
9f86d081…a08
9f86d081…a08
Plan for human review
Emit versioned JSON and human-readable reports that describe proposed actions while preserving the evidence that supports them.
Safety boundary
Observation is not permission to mutate.
OptiFlow v0.1.x is deliberately read-only. It records what it saw, names what it could not prove, and stops at a reviewable plan.
Explore the safety model →Inside v0.1.x
- ✓ scan and observe
- ✓ prove exact matches
- ✓ report and plan
review boundary
Not implemented
- × delete
- × replace
- × transcode
Contracts, not vibes
Built to be checked by people and machines.
Install or build
Run an evidence-first scan.
Verified v0.1.0 binaries are published. Verify a supported release bundle or build the current read-only CLI from source, then point it at a directory you want to understand.
cargo run -- scan ~/Media