runs

Every time you generate a video, immich-memories tracks the run: what settings you used, how long it took, how many clips were processed, errors, system info. The runs command lets you browse that history.

runs list

immich-memories runs list [OPTIONS]

Flag	Short	Type	Default	Description
--limit	-n	int	20	Number of runs to show
--person	-p	string	—	Filter by person name
--status	-s	choice	—	completed, failed, running, cancelled, interrupted

Examples:

# Recent runs
immich-memories runs list

# Just the failures
immich-memories runs list --status failed

# Runs for a specific person
immich-memories runs list --person "Emma" --limit 5

runs show

Detailed view of a single run. Shows status, date range, clip counts, output file size, phase-by-phase timing breakdown, and system info (CPU, GPU, RAM, FFmpeg version).

immich-memories runs show RUN_ID

You can use a partial run ID: if it's unambiguous, it'll match:

immich-memories runs show 20260105_1430

Model spend

runs show reports what the run spent on the LLM — calls, judgment-cache hits, tokens, wall time, and any thinking calls truncated at the token budget.

It is reported per run, not per phase, and the phase table is labelled "recorded phases only" for the same reason: the run tracker records clip extraction, assembly and music, all of which happen after selection. Analysis and selection run before the run row exists and account for most of the model budget, so a per-phase total would understate the bill.

runs stats

Aggregate statistics across all your runs:

immich-memories runs stats

Shows total runs, completion rate, total video generated, total processing time, average clips per run, etc.

runs delete

Delete a run record and optionally its output video:

# Delete the run and its output file
immich-memories runs delete 20260105_143052_a7b3

# Delete the record but keep the video
immich-memories runs delete 20260105_143052_a7b3 --keep-output

# Skip the confirmation prompt (scripts)
immich-memories runs delete 20260105_143052_a7b3 --yes

You'll get a confirmation prompt before anything is deleted unless you pass --yes.

runs storage

Report the configured output and cache locations and how much they hold, without changing anything:

immich-memories runs storage
immich-memories runs storage --json   # machine-readable