id          = "himalaya"
name        = "Himalaya"
homepage    = "https://github.com/pimalaya/himalaya"
description = "CLI to manage emails."
executables      = ["himalaya"]

[dotfiles]

# The official README and config.sample.toml list these persistent config
# locations (first valid path wins): $XDG_CONFIG_HOME/himalaya/config.toml,
# $HOME/.config/himalaya/config.toml, and $HOME/.himalayarc.
# https://github.com/pimalaya/himalaya#configuration
# https://github.com/pimalaya/himalaya/blob/master/config.sample.toml
paths = [
  "[configHome]/himalaya/config.toml",
  "~/.config/himalaya/config.toml",
]
secret = ["~/.himalayarc"]

# config.sample.toml documents raw password/token alternatives for every
# supported authentication family. Command/keyring forms are intentionally not
# secrets in this file; these patterns cover only values that are actually
# embedded in the TOML.
[[dotfiles.secret_paths]]
file = ["[configHome]/himalaya/config.toml", "~/.config/himalaya/config.toml"]
format = "toml"
match = { key_path = [
  "accounts.*.imap.sasl.plain.password.raw",
  "accounts.*.imap.sasl.login.password.raw",
  "accounts.*.imap.sasl.oauthbearer.token.raw",
  "accounts.*.imap.sasl.xoauth2.token.raw",
  "accounts.*.imap.sasl.scram-sha-256.password.raw",
  "accounts.*.smtp.sasl.plain.password.raw",
  "accounts.*.smtp.sasl.login.password.raw",
  "accounts.*.smtp.sasl.oauthbearer.token.raw",
  "accounts.*.smtp.sasl.xoauth2.token.raw",
  "accounts.*.smtp.sasl.scram-sha-256.password.raw",
  "accounts.*.jmap.auth.header.raw",
  "accounts.*.jmap.auth.bearer.token.raw",
  "accounts.*.jmap.auth.basic.password.raw",
  "accounts.*.gmail.auth.token.raw",
  "accounts.*.msgraph.auth.token.raw",
] }

[commands]
format = 1
label = "Himalaya"
description = "List envelopes with himalaya envelope list. Other subcommands and protocol-specific APIs are left out."
quality = "ai-draft"
parser = { end_of_options = "--", interleave = "permute", long_equals = true, short_attached = false, short_bundles = false }

[[commands.subcommand]]
path = ["envelope", "list"]
label = "List envelopes"

[[commands.subcommand.source]]
id = "readme"
kind = "manual"
url = "https://raw.githubusercontent.com/pimalaya/himalaya/HEAD/README.md"
revision = "2026-10-27"
evidence = """Backend-agnostic commands run on the account's first configured backend, or the one picked with `-b/--backend`. `-m/--mailbox` takes a mailbox id, name, alias or role (`inbox`, `sent`, `drafts`, `trash`...), and defaults to the inbox.
himalaya envelope list --page 2"""

[[commands.subcommand.field]]
id = "mailbox"
label = "Mailbox"
description = "Id, name, alias or role; defaults to the inbox."
type = "string"
option = ["--mailbox", "-m"]
suggestions = [{ value = "inbox", label = "Inbox" }, { value = "sent", label = "Sent" }, { value = "drafts", label = "Drafts" }, { value = "trash", label = "Trash" }]
sources = ["readme"]

[[commands.subcommand.field]]
id = "backend"
label = "Backend"
type = "string"
option = ["--backend", "-b"]
sources = ["readme"]

[[commands.subcommand.field]]
id = "page"
label = "Page"
type = "integer"
option = ["--page"]
sources = ["readme"]

[[commands.subcommand.task]]
id = "list"
label = "List a mailbox"
fields = ["mailbox", "page"]

[[commands.subcommand.group]]
id = "basic"
label = "Basic"
fields = ["mailbox", "page", "backend"]