noxdir: Explore Disk Usage in a Terminal

Overview

NoxDir scans mounted drives or a chosen directory and presents file and directory usage in an interactive terminal interface. It helps users find where storage is going and navigate to large items without relying on a graphical disk analyzer.

It is designed for hands-on exploration rather than scripting or headless use. Use it when you want an interactive view of a file system and can wait for an initial scan, or narrow the scan with a root directory and exclusions.

Key Features

• Displays disk usage for mounted drives and volumes, or a directory selected with --root.
• Provides keyboard-driven navigation and configurable key bindings.
• Supports filters for hidden files, empty directories, excluded paths, and file size limits.
• Can cache scan results and refresh selected directories on demand.
• Compares current contents with cached data to highlight additions, deletions, and usage changes.
• Allows customization of UI colors and glyphs through a JSON schema.

Use Cases

• A desktop user looking for large folders before freeing disk space.
• A developer narrowing a scan to a project directory or excluding bulky directories such as node_modules.
• A user revisiting a large volume who wants cached results instead of repeating a full scan each time.
• Someone checking how a directory changed since a previous cached session.

Getting Started

Install with Go 1.26 and launch the interactive interface:

go install github.com/crumbyte/noxdir@latest
noxdir

See the README for platform-specific installation options, flags, and configuration details.

Considerations

NoxDir is intended for interactive terminal use and is not currently suited to scripts or headless environments. Initial scans can take time on volumes with many files; caching, exclusions, or scanning a specific root can help. Its visual presentation depends on terminal and font support for Unicode glyphs. The README describes the tool as read-only except for deletion, which requires confirmation.