# dundee/gdu

> gdu is a console disk usage analyzer for finding out how much space directories and files take up. It scans a directory tree and reports the sizes in an interactive terminal view, or as plain statistics or JSON when its output is redirected. The project is written in Go.

Source: https://github.com/dundee/gdu
Indexed: commit 02225e4 on 2026-06-04 by Repowise. Facts come from the source and git history, not from the maintainer.

## Facts

- Type: App
- Language: Go
- Stars: 6,203 at index time
- License: MIT
- Code health: 6.8/10, Fair
- Last commit: 2026-06-02

## How it works

The program starts from cmd/gdu/main.go, which hands control to the app code in cmd/gdu/app/app.go. The pkg directory holds most of the core code, and pkg/analyze/sqlite.go and pkg/analyze/stored.go deal with saving analysis data to a database so it can be reloaded later. The tui directory contains the terminal user interface used in interactive mode. Non-interactive mode is chosen automatically when no TTY is detected, and export mode with -o writes all usage data as JSON, which the -f flag can read back. The internal directory holds shared helpers such as internal/common/app.go.

- cmd/gdu/app/app.go: entry point
- cmd/gdu/main.go: entry point
- internal/common/app.go: entry point
- internal/testapp/app.go: entry point
- .github/ISSUE_TEMPLATE/bug_report.md: central file
Modules: pkg, tui, internal, root, .github, docs, cmd, report. 158 files, 18,841 lines, 1,371 symbols.

## Code health

- Score: 6.8/10 (Fair)
- Rank: #166 of 4,000+ indexed repos
- Hotspots: pkg/analyze/sqlite.go, pkg/analyze/parallel_top_dir.go, stdout/stdout_test.go, pkg/analyze/sqlite_test.go, pkg/analyze/stored.go
- Lowest file: pkg/analyze/parallel_stable.go
- Dead code: 14 findings

## Maintenance

- Last commit 2026-06-02
- bus factor 1

## Security

- Security findings are shown to signed-in users at https://repowise.dev/repo/dundee/gdu/security

## More

- Page: https://repowise.dev/repo/dundee/gdu
- Ask this codebase: https://repowise.dev/repo/dundee/gdu/chat
- Docs: https://repowise.dev/repo/dundee/gdu/docs
- MCP (signs in with Repowise on first use):
    claude mcp add --transport http repowise https://api.repowise.dev/mcp/dundee/gdu
