How to

Clean closed records

Preview expired closed records or delete them with explicit confirmation.

What changes

clean is preview-only by default and never targets open work. --delete asks for confirmation interactively; add --yes for confirmed non-interactive deletion.

When this helps

Local storage has old closed records.
A repo needs a cache cleanup without touching active work.
You want to preview which closed records are eligible for removal.

Run this command

terminal

$sumr mission clean# preview the default 30-day retention set$sumr mission clean --older-than 30 --delete# ask before deleting in an interactive terminal$sumr mission clean --older-than 30 --delete --yes# confirm deletion for automation

Flags you can use

--older-than <days>

Set the retention threshold for closed records.

--dry-run

Explicitly preview eligible cache without deleting it.

--delete

Delete eligible closed Mission cache.

--yes

Confirm non-interactive deletion.

--json

Return a structured JSON envelope for scripts, CI jobs, and AI assistants.

--help, -h

Show the command syntax, supported flags, and examples without changing files.

Keep in mind

--delete without --yes prompts in an interactive terminal and fails safely in non-interactive mode. --yes is valid only with --delete.
--older-than must be a positive integer no greater than 36500. --dry-run and --delete cannot be combined.
Planning, blocked, in-progress, review, validated, and QA-failed Missions are not cleanup candidates.