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]
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"]
