clean

# Clean - Cleanup & Maintenance

## Overview

The `clean` development commands remove build artifacts, caches, containers, and other temporary files to recover disk space and reset the development environment.

**Key Concept:** This is a **development command** - run with `just` from the repository root, not `ujust`. It provides both interactive menu and non-interactive modes.

## Quick Reference

| Action | Command | Description |
|--------|---------|-------------|
| Interactive menu | `just clean` | Show cleanup options |
| Status report | `just clean status` | Show what would be cleaned |
| Safe cleanup | `just clean all` | Safe cleanup (preserves running containers) |
| Nuclear cleanup | `just clean nuke` | NUCLEAR: destroy everything (requires NUKE confirmation) |
| Podman prune | `just clean podman` | Full podman system prune |
| Images | `just clean images` | Dangling images only |
| All images | `just clean images all` | All unused images |
| Build cache | `just clean images build-cache` | Podman builder cache |
| Containers | `just clean containers` | Stopped containers |
| Runners | `just clean runners` | Stop/restart GitHub runners |
| VMs | `just clean vm` | VM images (libvirt + cache) |
| System | `just clean system` | Tmp files + journal |
| Logs | `just clean logs` | Remove *.log files |
| Docs | `just clean docs` | Remove site/ directory |
| Output | `just clean output` | Remove output/ contents |
| Cache menu | `just clean cache` | Cache cleanup submenu |
| Pixi cache | `just clean cache pixi` | .pixi/ + ~/.cache/rattler |
| Venv | `just clean cache venv` | venv/ directory |
| Chunkhound | `just clean cache chunkhound` | .chunkhound/ directory |
| Pip | `just clean cache pip` | ~/.cache/pip/ |
| Pre-commit | `just clean cache precommit` | ~/.cache/pre-commit/ |
| GitHub CLI | `just clean cache gh` | ~/.cache/gh/ |

## Safe vs Nuclear Cleanup

### Safe Cleanup (`just clean all`)

Safe cleanup that preserves running containers and configurations:

1.