Commands

media-ingest is a single CLI with seven subcommands. They run in a fixed order, and each one reads what the previous one wrote.

• init writes the ingest.toml config at the project root.
• scan reads metadata and hashes into .ingest/manifest.json. Read-only.
• plan computes renames, warnings, and the HTML report. Read-only.
• align shows what every device captured around a clip, using iPhone media as the trusted clock.
• apply performs journaled, idempotent, same-volume renames.
• undo reverses every journaled rename.
• report regenerates the HTML report from the existing plan.

Finding the project root

Every command except init looks for ingest.toml in the current directory and then walks up through parent directories until it finds one. That means you can run media-ingest scan, plan, apply, and so on from anywhere inside the project tree, not just from the root. If no config is found, the command tells you to run media-ingest init first.

Commands that operate on an existing project also accept a --root option to point at a specific project directory explicitly.

Read-only versus destructive

scan, plan, align, and report never touch your media files. They only read the media and write into .ingest/. The only command that renames files is apply, and the only command that moves them back is undo. See the safety model for the guarantees around apply and undo.