Using lla

Disk scan

Find out what is filling your disk, see what is safe to remove, and move it to the trash from one screen.

↓ on this page

lla scan reads your disk, groups everything it finds by what it is, and tells you which parts you can get back without losing anything. It runs on macOS, Linux and Windows.

lla scan               # your home folder, plus /Applications on macOS
lla scan ~/code        # one folder
lla scan --report      # print a summary instead
lla scan --json        # the same data for scripts
lla scan --no-duplicates   # skip the duplicate search
lla scan on a home folder.

In a terminal, lla scan opens the interactive view. With --report or --json, or when the output is piped, it prints a summary and exits.

What it shows

The top of the screen shows how full the volume is and a dot map of the whole disk, one color per category. Below it, everything lla found is grouped like this:

CategoryWhat lands there
AppsInstalled apps and the data they keep: /Applications, ~/Library/Application Support, %LOCALAPPDATA%, Flatpak, Snap, /opt. iPhone and iPad backups too, one item per device
DeveloperBuild and dependency folders found anywhere (node_modules, Rust target, .next, Pods, DerivedData and more), package caches, toolchains, and Xcode and container disk images
Caches~/Library/Caches, ~/.cache, %TEMP%, /var/cache
Logs~/Library/Logs, /var/log, crash dumps
Downloads, Documents, Photos, Videos, MusicThe usual folders, plus iCloud Drive and OneDrive
TrashWhat is already in the trash: ~/.Trash, ~/.local/share/Trash, and your Recycle Bin on each fixed drive on Windows
OtherEverything else in the scanned folders
System & otherWhat the disk reports as used minus everything lla found: the OS, swap, snapshots, other users, and folders lla couldn't read

A build folder only counts as one when its project file sits next to it, so target needs a Cargo.toml and bin needs a .csproj. Every byte is counted once: a node_modules inside ~/Documents shows up under Developer and is taken out of the Documents total.

Sizes are the space files actually take on disk, so sparse and cloud-only files count for what they really use. Hard links are counted once, and the scan stays on the filesystem it started on.

Developer tools

WhatWhereLabel
Xcode DerivedData, DeviceSupport for iOS, watchOS, tvOS and visionOS, SwiftUI previews~/Library/Developer/Xcode/...safe to clean
Simulator caches~/Library/Developer/CoreSimulator/Cachessafe to clean
Simulators~/Library/Developer/CoreSimulator/Devicesreview first. xcrun simctl delete unavailable removes old ones
Xcode archives~/Library/Developer/Xcode/Archivesreview first
Docker disk image~/Library/Containers/com.docker.docker, %LOCALAPPDATA%\Docker (the WSL .vhdx), /var/lib/dockerreview first. docker system prune frees space inside it
OrbStack, Colima and Lima disks~/Library/Group Containers/HUAQ24HBR6.dev.orbstack, ~/.colima, ~/.limareview first
Homebrew downloads~/Library/Caches/Homebrew, ~/.cache/Homebrew or $HOMEBREW_CACHEsafe to clean, like brew cleanup
Package cachesnpm, pnpm, Yarn, Bun, Cargo, Gradle, Maven, Go modules, pip, uv and NuGet, including their %LOCALAPPDATA% versions on Windowssafe to clean

The Homebrew Caskroom and Cellar hold installed software, not cache, so lla leaves them alone. lla only reads these folders. It never runs docker, brew or xcrun for you.

iPhone and iPad backups are listed under the device name stored in each backup. They live in ~/Library/Application Support/MobileSync/Backup on macOS, and in %APPDATA%\Apple Computer\MobileSync\Backup or %USERPROFILE%\Apple\MobileSync\Backup on Windows. Remove old ones from Finder or iTunes when you can, so the device list there stays in sync.

Labels

Each item gets one of three labels:

LabelMeaning
safe to cleanRebuilt or downloaded again on its own, or already in the trash.
review firstProbably fine to remove, but look first: apps, downloads, toolchains, virtualenvs.
your filesDocuments, photos and the like. lla never suggests removing these.

Anything that hasn't been touched in three months is also marked as probably unused.

Duplicates

After the scan, lla looks for large files, 1 MB and up, stored more than once in the scanned folders. It groups them by size, compares the first and last 64 KB, then confirms with a SHA-256 of the whole file. This runs in the background, so you can use the view right away, and the header shows how far along it is.

Only your own files are compared. lla skips app data (~/Library, %APPDATA%), caches, build folders, device backups, the trash, hidden folders, git checkouts, and macOS packages such as apps and Photos libraries. Removing one file from inside those breaks the whole thing, and most of them are already offered for cleaning as a whole. Hard links are one file with several names, so they aren't reported.

Duplicates appears below the categories. Each row is one file, with how many copies there are and how much removing the extras would free. Enter shows the copies, Space marks one, and a marks every copy but the first. You can never mark every copy of a file. If a folder you marked would take the last copy with it, the confirmation leaves one out and says which.

Clean up

Open a category with Enter, mark what you want gone with Space, then press d. Nothing is removed until you confirm a list of every path and the total size.

KeyAction
↑ ↓, j kMove
Enter →, lOpen a category or folder, or show a duplicate's copies
Esc ←, hGo back
TabNext category
SpaceMark or unmark
aMark everything cleanable in the list. In Duplicates, every copy but one
uClear the marks
dMove the marked items, or the highlighted one, to the trash
DDelete the marked items for good
gJump to the biggest part of a folder
oReveal in Finder, Explorer or your file manager
fShow only cleanable and unused items
sSort by size, age or name
rScan again
?Help
qQuit

d moves things to the trash, so you can put them back. Items that are already in the trash are deleted for good, and the confirmation says so. Moving something to the trash doesn't free space until you empty it; the Trash category shows what is waiting there.

lla refuses to remove your home folder, the folders it groups by (such as ~/Library/Caches itself), anything above them, and folders like ~/.ssh and ~/.config.

Permissions

The number of folders lla couldn't read is shown at the top, and their size ends up in System & other.

  • macOS: give your terminal Full Disk Access in System Settings › Privacy & Security. Without it, macOS may ask once for access to folders like Documents, and some folders stay unreadable.
  • Linux: system folders such as /var/lib/docker need sudo lla scan.
  • Windows: some folders need an administrator terminal. lla finds your own Recycle Bin (X:\$Recycle.Bin\<your SID>) on each fixed drive and lists its entries under Trash by their original names. Removing one also removes its $I record, so Explorer doesn't show a broken entry. Other users' bins need administrator rights.

Report and JSON

--report prints the categories, the largest items that are safe to clean, the largest ones nobody has touched in three months, and the duplicates that waste the most space. --top N sets how many items each list shows. The default is 10.

lla scan ~ --report --top 5

--json prints the same data. Sizes are in bytes, modified is a Unix timestamp, and safety is safe, review or keep, matching the three labels:

{
  "volume": { "label": "startup disk", "total": 994662584320, "used": 951000000000, "free": 43662584320 },
  "roots": ["/Users/me", "/Applications"],
  "scanned_bytes": 693000000000,
  "files": 5121672,
  "unreadable_folders": 0,
  "elapsed_ms": 36300,
  "safe_bytes": 120000000000,
  "categories": [
    {
      "key": "developer",
      "label": "Developer",
      "bytes": 181000000000,
      "safe_bytes": 102000000000,
      "stale_bytes": 9200000000,
      "item_count": 3359,
      "items": [
        {
          "path": "/Users/me/code/app/node_modules",
          "bytes": 2300000000,
          "files": 48211,
          "modified": 1762300000,
          "safety": "safe",
          "reason": "reinstalled by your package manager",
          "stale": false,
          "protected": false,
          "loose_files": false,
          "label": null
        }
      ]
    }
  ],
  "duplicates": [
    {
      "bytes": 4200000000,
      "wasted_bytes": 4200000000,
      "paths": ["/Users/me/Movies/trip.mov", "/Users/me/Downloads/trip.mov"]
    }
  ]
}

For example, to list every safe-to-clean item over 1 GB:

lla scan --json | jq -r '.categories[].items[] | select(.safety == "safe" and .bytes > 1e9) | .path'