Clawker builds custom Docker images, creates config/history volumes, and spins up infrastructure containers (Envoy, CoreDNS, monitoring stack). Over time, these resources accumulate and can consume significant disk space — especially if you rebuild images frequently or work across many projects.
What accumulates
When to clean up
- Build failures mentioning disk space — Docker’s storage driver has a configurable cap. When reached, builds fail with
no space left on device or similar errors.
- Docker Desktop warnings — Docker Desktop shows disk usage in Settings > Resources. If the virtual disk is near its limit, clawker builds will fail.
- Slow builds — An oversized build cache can degrade BuildKit performance.
- General housekeeping — periodic cleanup prevents surprise failures during time-sensitive work.
Cleanup commands
Clawker-managed resources
Clawker labels all its resources (dev.clawker.*), so its own prune commands only affect clawker resources:
clawker volume prune removes all unused agent volumes by default — workspace, config, and command history. Config and history volumes persist your agent’s settings and shell history across sessions, so they will be lost if the matching agent container is not running at prune time. Passing --all widens the sweep further to infrastructure volumes (monitoring stack and any other clawker-managed volumes). Use clawker volume list and clawker volume remove for targeted cleanup instead.
Docker-wide cleanup
When clawker-specific cleanup isn’t enough, use Docker’s built-in commands to reclaim space from all Docker resources — not just clawker’s:
Checking disk usage
Recommended routine
There’s no need for a strict schedule — just prune when disk usage is becoming a problem or before it does. A reasonable habit:
- Run
docker system df to see where space is going
- Start with
clawker image prune — old images are usually the biggest win
- If builds are still failing, run
docker builder prune to clear the BuildKit cache
- Use
docker system prune as a last resort for a broader sweep