id          = "erdtree"
name        = "erdtree"
homepage    = "https://github.com/solidiquis/erdtree"
description = "A modern, cross-platform, multi-threaded filesystem and disk-usage utility."
executables      = ["erd"]

[dotfiles]

# The official README documents both config formats and their Unix/Windows
# search paths. These are the user-wide Unix spellings: XDG config (represented
# by [configHome]), ~/.config fallback, and ~/.erdtreerc legacy fallback, plus
# the TOML equivalents. Project-local files and explicit environment overrides
# are intentionally omitted.
# https://github.com/solidiquis/erdtree#configuration-file
paths = [
  "[configHome]/erdtree/.erdtreerc",
  "[configHome]/.erdtreerc",
  "~/.config/erdtree/.erdtreerc",
  "~/.erdtreerc",
  "[configHome]/erdtree/.erdtree.toml",
  "[configHome]/.erdtree.toml",
  "~/.config/erdtree/.erdtree.toml",
  "~/.erdtree.toml",
]
secret = []

[commands]
format = 1
label = "Show directory tree"
description = "Print a directory tree with disk usage using erd. Config files, completions, thread tuning and column-width options 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/solidiquis/erdtree"
revision = "2026-10-27"
evidence = """
Usage: erd [OPTIONS] [DIR]
  [DIR]
          Directory to traverse; defaults to current working directory
  -d, --disk-usage <DISK_USAGE>
          Possible values:
          - logical:
          - physical:
          - line:
          - word:
          - block:
  -H, --human
          Print disk usage in human-readable format
  -i, --no-ignore
          Do not respect .gitignore files
  -I, --icons
          Display file icons
  -l, --long
          Show extended metadata and attributes
  -L, --level <NUM>
          Maximum depth to display
  -p, --pattern <PATTERN>
          Regular expression (or glob if '--glob' or '--iglob' is used) used to match files
      --glob
          Enables glob based searching
  -P, --prune
          Remove empty directories from output
  -s, --sort <SORT>
          Possible values:
          - name:    - rname:   - size:    - rsize:   - access:  - raccess:
          - create:  - rcreate: - mod:     - rmod:
  -y, --layout <LAYOUT>
          Possible values:
          - regular:  - inverted: - flat:     - iflat:
  -., --hidden
          Show hidden files
      --dirs-only
          Only print directories
      --suppress-size
          Omit disk usage from output
"""

[[commands.field]]
id = "dir"
label = "Directory"
description = "Defaults to the current directory."
type = "path"
position = 0
path = { kind = "directory", role = "input" }
sources = ["help"]

[[commands.field]]
id = "level"
label = "Max depth"
type = "integer"
option = ["--level", "-L"]
sources = ["help"]

[[commands.field]]
id = "human"
label = "Human-readable sizes"
type = "boolean"
option = ["--human", "-H"]
sources = ["help"]

[[commands.field]]
id = "disk_usage"
label = "Size metric"
type = "enum"
option = ["--disk-usage", "-d"]
choices = [{ value = "logical", label = "Logical bytes" }, { value = "physical", label = "Physical bytes on disk" }, { value = "line", label = "Line count" }, { value = "word", label = "Word count" }, { value = "block", label = "Blocks" }]
sources = ["help"]

[[commands.field]]
id = "sort"
label = "Sort order"
type = "enum"
option = ["--sort", "-s"]
choices = [{ value = "name", label = "Name" }, { value = "rname", label = "Name (reversed)" }, { value = "size", label = "Size, smallest first" }, { value = "rsize", label = "Size, largest first" }, { value = "mod", label = "Modified, newest first" }, { value = "rmod", label = "Modified, oldest first" }]
sources = ["help"]

[[commands.field]]
id = "layout"
label = "Layout"
type = "enum"
option = ["--layout", "-y"]
choices = [{ value = "regular", label = "Regular (root at bottom)" }, { value = "inverted", label = "Inverted (root at top)" }, { value = "flat", label = "Flat paths" }, { value = "iflat", label = "Inverted flat" }]
sources = ["help"]

[[commands.field]]
id = "hidden"
label = "Show hidden files"
type = "boolean"
option = ["--hidden", "-."]
sources = ["help"]

[[commands.field]]
id = "no_ignore"
label = "Ignore .gitignore"
description = "Do not respect .gitignore files."
type = "boolean"
option = ["--no-ignore", "-i"]
sources = ["help"]

[[commands.field]]
id = "long"
label = "Long view"
type = "boolean"
option = ["--long", "-l"]
sources = ["help"]

[[commands.field]]
id = "icons"
label = "File icons"
type = "boolean"
option = ["--icons", "-I"]
sources = ["help"]

[[commands.field]]
id = "dirs_only"
label = "Directories only"
type = "boolean"
option = ["--dirs-only"]
sources = ["help"]

[[commands.field]]
id = "pattern"
label = "Match pattern"
description = "Regular expression used to match files."
type = "string"
option = ["--pattern", "-p"]
sources = ["help"]

[[commands.field]]
id = "prune"
label = "Prune empty directories"
type = "boolean"
option = ["--prune", "-P"]
sources = ["help"]

[[commands.task]]
id = "usage"
label = "Disk usage overview"
fields = ["dir", "level", "human", "sort"]
set = { human = [true] }

[[commands.task]]
id = "find"
label = "Find files by pattern"
fields = ["dir", "pattern", "prune", "hidden"]
required = ["pattern"]
set = { prune = [true] }

[[commands.group]]
id = "basic"
label = "Basic"
fields = ["dir", "level", "human", "disk_usage", "sort", "layout", "hidden"]

[[commands.group]]
id = "advanced"
label = "Advanced"
fields = ["no_ignore", "long", "icons", "dirs_only", "pattern", "prune"]