Skip to content

v1.6.0

Choose a tag to compare

@jasondockery jasondockery released this 12 Jul 05:59

New command: groundwork-doctor

A read-only machine health report. It never installs, deletes, prunes, or changes settings — it tells you what it found and hands you the owner-scoped way to act on it.

The first module covers Docker machine health:

  • Daemon reachability (with the right start command for your setup).
  • Engine hygiene: warns when container logs don't rotate (log-driver not local) and when the containerd image store — which local multi-platform builds expect — is off. Work Macs get both from the managed Colima template; on Docker Desktop these are one-time settings the doctor now verifies instead of trusting.
  • Disk usage (docker system df) plus a leftovers count: stopped containers, dangling images, dangling volumes — with guidance that routes cleanup to each repo's own clean commands and warns against blanket docker system prune.

Run groundwork-doctor any time disk feels tight, or after setting up a machine. groundwork-help doctor shows the catalog entry. Planned next module (see ROADMAP): competing-app detection.

After updating

Run chezmoi update, then try groundwork-doctor. If it warns about log-driver, the Platforms page has the exact Docker Desktop engine JSON to paste.