id = "wtfutil"
name = "WTF"
homepage = "https://wtfutil.com/"
description = "Personal information dashboard for your terminal"
executables = ["wtfutil"]

[dotfiles]

# WTF's official configuration-files page documents
# ~/.config/wtf/config.yml as the user configuration file.
# https://wtfutil.com/configuration/files/
paths = ["[configHome]/wtf/config.yml"]
secret = []

# The global-settings documentation defines githubAPIKey as a credential in
# the YAML configuration, so only that key is carved out of the settings.
# https://wtfutil.com/configuration/global_settings/
[[dotfiles.secret_paths]]
file = "[configHome]/wtf/config.yml"
format = "yaml"
match = { key_path = ["wtf.exitMessage.githubAPIKey"] }

[commands]
format = 1
label = "Run WTF"
description = "Start the dashboard, or show info about one module. Source: wtfutil flags.go (go-flags struct tags). The save-secret command 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 = "flags"
kind = "help"
url = "https://raw.githubusercontent.com/wtfutil/wtf/HEAD/flags/flags.go"
revision = "2026-10-27"
evidence = """
-c, --config   Path to config file
-m, --module   Display info about a specific module, i.e.: 'wtfutil -m=todo'
-v, --version  Show version info
"""

[[commands.field]]
id = "config"
label = "Config file"
type = "path"
option = ["--config", "-c"]
path = { kind = "file", role = "input", must_exist = true }
sources = ["flags"]

[[commands.field]]
id = "module"
label = "Module info"
description = "Show info about a specific module, for example todo."
type = "string"
option = ["--module", "-m"]
sources = ["flags"]

[[commands.field]]
id = "version"
label = "Show version"
type = "boolean"
option = ["--version", "-v"]
sources = ["flags"]

[[commands.task]]
id = "start"
label = "Start with a config file"
fields = ["config"]
required = ["config"]

[[commands.task]]
id = "module-info"
label = "Show module info"
fields = ["module"]
required = ["module"]

[[commands.group]]
id = "basic"
label = "Basic"
fields = ["config", "module", "version"]