# cull

> Interactive TUI disk space analyzer for scanning directories, finding large files, and deleting them from the terminal.

Stars: 168 · Categories: File Management

- Repository: https://github.com/legostin/cull
- Page: https://www.trmn.sh/tools/cull

## Install

- Homebrew: `brew tap legostin/tap && brew install cull`
- APT (Linux): `echo "deb [trusted=yes] https://legostin.github.io/apt-repo/ /" | sudo tee /etc/apt/sources.list.d/cull.list && sudo apt update && sudo apt install cull`
- Go: `go install github.com/legostin/cull@latest`

## Overview

Cull is a terminal user interface (TUI) disk space analyzer that helps identify and remove large files consuming disk space. The tool scans directories and displays file sizes in an interactive terminal interface, continuously updating directory sizes in the background as the scan progresses.

The interface provides multiple views for disk analysis: a Browse mode for navigating directories hierarchically, and a Largest tab that performs deep scans across all subdirectories to surface the biggest files system-wide. Users can select individual files or ranges of files using keyboard shortcuts, then delete them either by moving to trash or permanent deletion with confirmation dialogs.

Cull includes filtering capabilities that allow users to search for files by name or extension, multiple sorting modes (by size, name, or modification date), and support for toggling hidden file visibility. The tool offers safety features including a read-only mode for browsing without deletion capabilities, dry-run previews, and confirmation prompts. On macOS, it integrates with Quick Look for file previews directly within the terminal interface.

### Installation

```bash
# via Homebrew
brew tap legostin/tap && brew install cull
```

```bash
# via APT (Linux)
echo "deb [trusted=yes] https://legostin.github.io/apt-repo/ /" | sudo tee /etc/apt/sources.list.d/cull.list && sudo apt update && sudo apt install cull
```

```bash
# via Go
go install github.com/legostin/cull@latest
```

![Browse and navigate interface](https://media.trmn.sh/cached/213a85c40cd95f42a9baa6d68c0b8a229107c0d028d06a93120e130792b2bdda.gif)

![Safe delete functionality](https://media.trmn.sh/cached/ecb8f0c8c465f245aae56905db05a1963e8deba2926c0ea100f5278c558f7491.gif)

![Largest files tab](https://media.trmn.sh/cached/5635e9f263f37772e7ac3311c8ace338720bd3893f565dfba270ab07ccbdd428.gif)

## Alternatives

- [bt](https://www.trmn.sh/tools/bt.md): TUI file manager with tree-based navigation for manipulating files and directories in terminal (167 stars)
- [deletor](https://www.trmn.sh/tools/deletor.md): File deletion tool with interactive TUI and CLI modes supporting filters, trash integration, and batch operations. (261 stars)
- [bkp](https://www.trmn.sh/tools/bkp.md): Simple command-line utility for creating numbered backups of files and directories with optional TAR archiving. (24 stars)
- [notox](https://www.trmn.sh/tools/notox.md): CLI tool for renaming files to remove toxic or problematic characters from filenames (Rust, 16 stars)
- [hazelnut](https://www.trmn.sh/tools/hazelnut.md): Terminal-based automated file organizer that watches folders and applies rules to move, copy, rename, or delete files based on patterns (Rust, 327 stars)

## Guides

- [Modern Replacements for du](https://www.trmn.sh/replace/du): Compare dust, dua, erdtree and pdu as replacements for du: output format, filtering, JSON output, gitignore handling and interactive deletion.
- [Best Disk Usage Analyzers](https://www.trmn.sh/best/disk-usage-analyzers): Compare dust, dua, and diskonaut plus pdu, cull and erdtree for finding what fills your disk from the terminal.

---

Canonical: https://www.trmn.sh/tools/cull