GitHub - evilmarty/duex: Duex is a Go-based terminal utility for visualizing and analyzing disk usage, featuring interactive navigation, accurate sizing, and real-time feedback. · GitHub
/" data-turbo-transient="true" />
Skip to content
Search or jump to...
Search code, repositories, users, issues, pull requests...
-->
Search
Clear
Search syntax tips
Provide feedback
--><br>We read every piece of feedback, and take your input very seriously.
Include my email address so I can be contacted
Cancel
Submit feedback
Saved searches
Use saved searches to filter your results more quickly
-->
Name
Query
To see all available qualifiers, see our documentation.
Cancel
Create saved search
Sign in
/;ref_cta:Sign up;ref_loc:header logged out"}"<br>Sign up
Appearance settings
Resetting focus
You signed in with another tab or window. Reload to refresh your session.<br>You signed out in another tab or window. Reload to refresh your session.<br>You switched accounts on another tab or window. Reload to refresh your session.
Dismiss alert
{{ message }}
evilmarty
duex
Public
Notifications<br>You must be signed in to change notification settings
Fork
Star
main
BranchesTags
Go to file
CodeOpen more actions menu
Folders and files<br>NameNameLast commit message<br>Last commit date<br>Latest commit
History<br>39 Commits<br>39 Commits
.agents/skills
.agents/skills
.github
.github
pkg/analyzer
pkg/analyzer
.gitignore
.gitignore
.goreleaser.yaml
.goreleaser.yaml
AGENTS.md
AGENTS.md
LICENSE
LICENSE
README.md
README.md
go.mod
go.mod
go.sum
go.sum
main.go
main.go
main_test.go
main_test.go
View all files
Repository files navigation
duex - Disk Usage Explorer
duex is a fast, interactive terminal-based disk usage utility written in Go. It helps you understand what is consuming space on your drives by providing a navigable, visual breakdown of folders and files.
Features
Interactive TUI : Built with the Charm ecosystem (Bubble Tea, Bubbles, Lip Gloss) for a modern, responsive terminal experience.
Accurate Sizing : Calculates actual physical disk usage, properly handling hard links (no double-counting) and sparse files.
Fast & Concurrent : Uses Go routines for rapid, non-blocking directory traversal.
Real-time Progress : Visual feedback with an animated spinner and scrolling file list during heavy scans.
Instant Breakdowns : Automatically computes and displays a file extension breakdown for directories.
Filter & Search : Quickly find specific files in large directories.
Safe Navigation : Cancel long-running scans instantly with esc.
Installation
Using Homebrew
brew install evilmarty/duex/duex
Pre-built Binaries
You can download the latest release from GitHub Releases.
Building from Source
Make sure you have Go installed.
Clone the repository and build the executable:
git clone https://github.com/evilmarty/duex<br>cd duex<br>go build -ldflags="-X main.Version=v1.0.0" -o duex
You can then move the duex binary to a location in your $PATH.
Usage
Run duex in your current directory:
./duex
Or provide a specific path to scan:
./duex /path/to/scan
CLI Flags
Flag<br>Description
-h, --help<br>Show usage instructions
-v, --version<br>Show application version
Keyboard Shortcuts
Key<br>Action
↑ / k<br>Move cursor up
↓ / j<br>Move cursor down
enter<br>Open selected directory
backspace<br>Go up to parent directory
esc<br>Cancel active scan / Go back
Refresh (rescan current directory)
Filter files in current directory
q / ctrl+c<br>Quit application
Testing and Coverage
The project maintains a high standard of test coverage (95%+ for core packages).
To run the test suite:
go test ./...
To generate and view the detailed code coverage profile:
go test -coverprofile=coverage.out ./...<br>go tool cover -func=coverage.out
About
Duex is a Go-based terminal utility for visualizing and analyzing disk usage, featuring interactive navigation, accurate sizing, and real-time feedback.
Topics
cli
golang
utility
disk-space
disk-usage
Resources
Readme
License
GPL-3.0 license
Uh oh!
There was an error while loading. Please reload this page.
Activity
Stars
stars
Watchers
watching
Forks
forks
Report repository
Releases
v1.2.0
Latest
May 22, 2026
+ 2 releases
Packages
Uh oh!
There was an error while loading. Please reload this page.
Uh oh!
There was an error while loading. Please reload this page.
Contributors
Uh oh!
There was an error while loading. Please reload this page.
Languages
Go<br>100.0%
You can’t perform that action at this time.