Clean up batches

Each batch is a directory named agents-<date>-<time>-<uuid> under the remote root (~/vmup by default). vmup deletes those directories after TTL minutes (default 5). You can also delete them yourself.

Why batches expire is the design page. This page is the recipes.

Let the sweeper do it

vmup init (and vmup init -y) installs ~/vmup/.cleanup.sh on the host and a crontab line * * * * * that runs it every minute. The script finds agents-* and agents-*.partial directories older than TTL minutes and rm -rfs them. It does not delete the remote root.

Reinstall after you change TTL, or if someone deleted the script:

vmup check --sweeper

vmup check without --sweeper only reports:

Sweeper: missing
  Reinstall:  vmup check --sweeper

A successful upload that finds no executable ~/vmup/.cleanup.sh prints a yellow warning: batches may linger after TTL if this laptop sleeps. The client-side delete is a sleep then ssh rm in a detached process; it dies if the machine sleeps or exits.

Prune from this laptop

vmup prune

Deletes remote agents-* directories whose mtime is older than the resolved TTL, and any *.partial dirs. Prints Pruned N remote batch(es) on stderr.

vmup prune --id agents-20260911-140128-aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee

Deletes that batch (and its .partial sibling) regardless of age. The id must match agents-YYYYMMDD-HHMMSS-<uuid>.

vmup prune --local

Also removes local staging dirs under ~/.cache/vmup/ older than 24 hours. Prints Removed N local orphan batch(es) first, then does the remote prune.

vmup prune --install-sweeper

Installs/refreshes the remote cron script, then prunes.

vmup prune --ttl 1

Uses 1 minute as the age cutoff for this prune (and for sweeper install if you combined --install-sweeper). Does not rewrite config.toml.

Keep local staging after a good upload

vmup shot.png --keep-local

The remote copy is still uploaded. The leftover directory is:

~/.cache/vmup/agents-<date>-<time>-<uuid>/

Failed uploads keep staging even without --keep-local, so you can retry or inspect files.

Override the cache root with VMUP_CACHE_DIR or XDG_CACHE_HOME. See Environment variables.