gdu

name	gdu
description	Use this skill when the user wants to analyze disk usage, check disk space, or find large files and directories.

gdu Plugin

Fast disk usage analyzer with console interface written in Go. Analyze disk usage with visualization and filtering capabilities.

Commands

Disk Analysis

• gdu disk analyze — Analyze disk usage

Utility

• gdu _ _ — Passthrough to gdu CLI

Usage Examples

• "Analyze disk usage"
• "Check disk space"
• "Find large directories"
• "Show disk usage"

Installation

brew install gdu

Or via Go:

go install github.com/dundee/gdu/v5/cmd/gdu@latest

Examples

# Analyze current directory
gdu disk analyze .

# Analyze specific path
gdu disk analyze /home/user

# Color output
gdu disk analyze . --color always

# Show hidden files
gdu disk analyze . --show-hidden

# Don't follow symlinks
gdu disk analyze . --no-follow

# Ignore directories
gdu disk analyze . --ignore-dirs node_modules,vendor

# Any gdu command with passthrough
gdu _ _ . --color always
gdu _ _ /home/user --show-hidden

Key Features

• Fast - Written in Go for performance
• Visual - Colored output for easy reading
• Filtering - Ignore specific directories
• Symlinks - Follow or ignore symlinks
• Hidden files - Show or hide hidden files
• Cross-platform - Linux, macOS, Windows
• Interactive - Interactive mode available
• Export - Export analysis data
• Recursive - Analyze nested directories
• Efficient - Caching for faster repeated scans

Notes

• Default analyzes current directory
• Uses colors to highlight large directories
• Can be used in CI/CD pipelines
• Great for disk cleanup
• Supports multiple output formats