id = "neomutt"
name = "NeoMutt"
homepage = "https://neomutt.org/"
description = "A command-line mail reader based on the Mutt mail client."
executables = ["neomutt"]

[dotfiles]

# https://docs.neomutt.org/reference/config/files.html lists the XDG user
# configuration files ~/.config/neomutt/neomuttrc and ~/.config/neomutt/muttrc
# (with XDG_CONFIG_HOME replacing ~/.config). The separate neomutt directory
# avoids overlapping the legacy mutt paths owned by the mutt entry.
paths = []
secret = ["[configHome]/neomutt/neomuttrc", "[configHome]/neomutt/muttrc"]
side_effect = false

[commands]
format = 1
label = "Send or open mail"
description = "Open a mailbox, or compose a message with recipients, subject and attachments. Draft, include and debug options are left out."
quality = "ai-draft"
parser = { end_of_options = "--", interleave = "permute", long_equals = false, short_attached = false, short_bundles = false }

[[commands.source]]
id = "help"
kind = "manual"
url = "https://manpages.debian.org/unstable/neomutt/neomutt.1.en.html"
revision = "debian unstable"
evidence = """
  -a file
  Attach one or more files to a message (must be the last option).
  -b address
  Specify a blind carbon copy (Bcc) recipient
  -c address
  Specify a carbon copy (Cc) recipient
  -e command
  Specify a command to be run after reading the config files
  -F config
  Specify an alternative initialization file to read, see FILES
  -f mailbox
  Specify a mailbox (as defined with mailboxes command) to load
  -n
  Do not read the system-wide configuration file
  -R
  Open mailbox in read-only mode
  -s subject
  Specify a subject (must be enclosed in quotes if it has spaces)
"""

[[commands.field]]
id = "mailbox"
label = "Mailbox"
type = "string"
option = ["-f"]
sources = ["help"]

[[commands.field]]
id = "read_only"
label = "Read-only"
type = "boolean"
option = ["-R"]
sources = ["help"]

[[commands.field]]
id = "config"
label = "Config file"
type = "path"
option = ["-F"]
path = { kind = "file", role = "input" }
sources = ["help"]

[[commands.field]]
id = "no_system_config"
label = "Skip system-wide config"
type = "boolean"
option = ["-n"]
sources = ["help"]

[[commands.field]]
id = "subject"
label = "Subject"
type = "string"
option = ["-s"]
sources = ["help"]

[[commands.field]]
id = "cc"
label = "Cc"
type = "string"
option = ["-c"]
multiple = true
sources = ["help"]

[[commands.field]]
id = "bcc"
label = "Bcc"
type = "string"
option = ["-b"]
multiple = true
sources = ["help"]

[[commands.field]]
id = "startup_command"
label = "Run command after config"
type = "string"
option = ["-e"]
effect = "exec"
sources = ["help"]

[[commands.task]]
id = "open"
label = "Open a mailbox"
fields = ["mailbox", "read_only"]
required = ["mailbox"]

[[commands.task]]
id = "compose"
label = "Compose a message"
fields = ["subject", "cc", "bcc"]
required = ["subject"]

[[commands.group]]
id = "basic"
label = "Basic"
fields = ["mailbox", "read_only", "subject", "cc", "bcc"]

[[commands.group]]
id = "advanced"
label = "Advanced"
fields = ["config", "no_system_config", "startup_command"]