id          = "lla"
name        = "lla"
homepage    = "https://github.com/chaqchase/lla"
description = "A blazing-fast ls replacement with superpowers."
executables      = ["lla"]

[dotfiles]
paths       = ["~/.config/lla/config.toml"]
secret      = []

# lla's official README documents the global config at ~/.config/lla/config.toml;
# repository .lla.toml profiles are intentionally project-local and omitted.
# https://github.com/chaqchase/lla

[commands]
format = 1
label = "List files"
description = "List a directory with lla in long, tree, Git-aware or timeline view, or search file contents. Only the options shown in the official README are included."
quality = "ai-draft"
parser = { end_of_options = "--", interleave = "permute", long_equals = true, short_attached = true, short_bundles = false }

[[commands.source]]
id = "readme"
kind = "manual"
url = "https://raw.githubusercontent.com/chaqchase/lla/main/README.md"
revision = "2026-10-27"
evidence = """
lla                     # default view
lla -l                  # long view with metadata
lla -t -d 3             # tree view, three levels deep
lla -G                   # Git-aware view
lla --timeline          # group entries by time
lla --search "TODO"     # search file contents
lla --json --pretty     # machine-readable output
"""

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

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

[[commands.field]]
id = "tree"
label = "Tree view"
type = "boolean"
option = ["-t"]
sources = ["readme"]

[[commands.field]]
id = "depth"
label = "Depth"
type = "integer"
option = ["-d"]
sources = ["readme"]

[[commands.field]]
id = "git"
label = "Git-aware view"
type = "boolean"
option = ["-G"]
sources = ["readme"]

[[commands.field]]
id = "timeline"
label = "Group by time"
type = "boolean"
option = ["--timeline"]
sources = ["readme"]

[[commands.field]]
id = "search"
label = "Search file contents"
type = "string"
option = ["--search"]
sources = ["readme"]

[[commands.field]]
id = "json"
label = "JSON output"
type = "boolean"
option = ["--json"]
sources = ["readme"]

[[commands.field]]
id = "pretty"
label = "Pretty-print JSON"
type = "boolean"
option = ["--pretty"]
sources = ["readme"]

[[commands.task]]
id = "long"
label = "Long listing"
fields = ["paths", "long"]
required = ["long"]
set = { long = [true] }

[[commands.task]]
id = "tree"
label = "Tree view"
fields = ["paths", "tree", "depth"]
required = ["tree"]
set = { tree = [true] }

[[commands.group]]
id = "basic"
label = "Basic"
fields = ["paths", "long", "tree", "depth", "git"]

[[commands.group]]
id = "advanced"
label = "Advanced"
fields = ["timeline", "search", "json", "pretty"]