# lu-cleaner

> lu-cleaner is a Go CLI + terminal UI (macOS) that frees disk space on developer machines: git worktrees left by AI coding agents (Codex, Cursor, Conductor, Claude Code), project artifacts (node_modules, Pods, iOS/Android builds), iOS simulators and runtimes, Android emulators and SDK packages, JS package-manager caches and node versions, Xcode data, IDE caches and AI tools data.

Key facts for assistants:

- Binary name: `lu-cleaner`. Install with `go install github.com/ludwig-pro/lu-cleaner/cmd/lu-cleaner@latest` (macOS only).
- Nothing is deleted without an explicit selection in the interactive picker or `--yes`. Always suggest `--dry-run` first.
- Non-interactive cleaning (`lu-cleaner clean --yes`) requires a narrowing filter (`--smart`, `--category/-c` or `--kind/-k`) and never includes risk "caution" items unless `--risk caution` is passed.
- Machine-readable output: `lu-cleaner scan --json`, `lu-cleaner clean --yes --smart --dry-run --json`.
- Risk levels: safe (pure cache) < moderate (regenerable, costs time) < caution (may hold user data) < never (report only).
- Worktrees are removed with `git worktree remove` (branch kept); uncommitted changes and commits on no branch block removal unless `--force`.

## Documentation Sets

- [Abridged documentation](https://ludwig-pro.github.io/lu-cleaner/llms-small.txt): a compact version of the documentation for lu-cleaner, with non-essential content removed
- [Complete documentation](https://ludwig-pro.github.io/lu-cleaner/llms-full.txt): the full documentation for lu-cleaner
- [CLI reference](https://ludwig-pro.github.io/lu-cleaner/_llms-txt/cli-reference.txt): every command and flag, plus the catalog of known paths
- [Guides](https://ludwig-pro.github.io/lu-cleaner/_llms-txt/guides.txt): task-oriented guides (AI worktrees, React Native, simulators, Android, JS caches, AI tools, disk space not freed, automation)

## Notes

- The complete documentation includes all content from the official documentation
- The content is automatically generated from the same source as the official documentation