id       = "gdu"
name     = "gdu"
homepage = "https://github.com/dundee/gdu"
description = "A fast disk-usage analyzer with a console interface."
executables   = ["gdu"]

[dotfiles]

# https://github.com/dundee/gdu#configuration-file — gdu checks the optional
# YAML configuration files ~/.config/gdu/gdu.yaml and ~/.gdu.yaml by default.
paths = [
  "~/.gdu.yaml",
  "[configHome]/gdu/gdu.yaml",
]
secret = []
side_effect = false

[commands]
format = 1
label = "Analyze disk usage"
description = "Scan directories and show where the space goes, interactively or as a plain listing. Databases, exports, filters by age or type, the web UI and profiling are left out."
quality = "ai-draft"
parser = { end_of_options = "--", interleave = "permute", long_equals = true, short_attached = true, short_bundles = false }

[[commands.source]]
id = "help"
kind = "help"
url = "https://github.com/dundee/gdu#usage"
revision = "2026-10-27"
evidence = """
  -L, --follow-symlinks                Follow symlinks for files, i.e. show the size of the file to which symlink points to (symlinks to directories are not followed)
  -i, --ignore-dirs strings            Paths to ignore (separated by comma). Can be absolute or relative to current directory (default [/proc,/dev,/sys,/run])
  -x, --no-cross                       Do not cross filesystem boundaries
  -H, --no-hidden                      Ignore hidden directories (beginning with dot)
  -n, --non-interactive                Do not run in interactive mode
  -a, --show-apparent-size             Show apparent size
  -C, --show-item-count                Show number of items in directory
  -s, --summarize                      Show only a total in non-interactive mode
  -t, --top int                        Show only top X largest files in non-interactive mode
  -d, --show-disks                     Show all mounted disks
      --no-delete                      Do not allow deletions
"""

[[commands.field]]
id = "non_interactive"
label = "Plain listing (non-interactive)"
type = "boolean"
option = ["--non-interactive", "-n"]
sources = ["help"]

[[commands.field]]
id = "summarize"
label = "Only a total"
description = "Show only a total per path; implies the plain listing."
type = "boolean"
option = ["--summarize", "-s"]
sources = ["help"]

[[commands.field]]
id = "top"
label = "Top N largest files"
type = "integer"
option = ["--top", "-t"]
sources = ["help"]

[[commands.field]]
id = "no_cross"
label = "Stay on one filesystem"
type = "boolean"
option = ["--no-cross", "-x"]
sources = ["help"]

[[commands.field]]
id = "no_hidden"
label = "Skip hidden directories"
type = "boolean"
option = ["--no-hidden", "-H"]
sources = ["help"]

[[commands.field]]
id = "apparent_size"
label = "Apparent size"
type = "boolean"
option = ["--show-apparent-size", "-a"]
sources = ["help"]

[[commands.field]]
id = "item_count"
label = "Show item counts"
type = "boolean"
option = ["--show-item-count", "-C"]
sources = ["help"]

[[commands.field]]
id = "ignore_dirs"
label = "Ignore paths"
description = "Comma-separated paths to skip."
type = "string"
option = ["--ignore-dirs", "-i"]
sources = ["help"]

[[commands.field]]
id = "no_delete"
label = "Disallow deletions"
type = "boolean"
option = ["--no-delete"]
sources = ["help"]

[[commands.field]]
id = "show_disks"
label = "List mounted disks"
type = "boolean"
option = ["--show-disks", "-d"]
sources = ["help"]

[[commands.field]]
id = "paths"
label = "Directories to scan"
description = "Leave empty to scan the current directory."
type = "path"
position = 0
multiple = true
path = { kind = "directory", role = "input" }
sources = ["help"]

[[commands.task]]
id = "browse"
label = "Browse a directory"
fields = ["paths", "no_cross", "no_hidden", "no_delete"]
required = []

[[commands.task]]
id = "biggest"
label = "Top 20 largest files"
set = { non_interactive = [true], top = [20] }
lock = ["non_interactive"]
fields = ["paths", "top", "no_cross"]
required = []

[[commands.group]]
id = "basic"
label = "Basic"
fields = ["paths", "non_interactive", "summarize", "top", "no_cross"]

[[commands.group]]
id = "advanced"
label = "Advanced"
fields = ["no_hidden", "apparent_size", "item_count", "ignore_dirs", "no_delete", "show_disks"]