himalaya(1)

📦
version 2.2.1 · 4 versions
, in arch rolling

💌 himalaya — the manual page, but make it slay

okay so bestie, welcome to himalaya(1) 💖 this is the top-level page of the General Commands Manual for himalaya, your CLI bestie for managing emails. everything you need is right here, no cap.

✨ NAME ✨

himalaya — the CLI to manage emails 🎀

🌸 SYNOPSIS 🌸

himalaya [-c|--config] [-a|--account] [-b|--backend] [--json]
[--log-level] [--log-file] [-h|--help] [-V|--version] [subcommands]

💅 DESCRIPTION 💅

CLI to manage emails. that's the whole vibe, honestly 👑

first time here? 🫶 literally just run himalaya with no command — it offers to generate an account discovered from your email address, which himalaya configure does again later. everything discovery does not cover? you write by hand, bestie ✍️

🔥 OPTIONS 🔥

  • -c, --config <PATH> — override the default configuration file path. paths are shell-expanded then canonicalized, and several may be given at once, delimited by : like $PATH 🐚 the first is the base and the rest are merged on top, which is exactly how a public configuration stays separate from the private ones. iykyk.
  • -a, --account <NAME> — override the default account. an account name corresponds to an entry in the table at the root level of your TOML configuration file 💖
  • -b, --backend <BACKEND> [default: auto] — force a specific backend for cross-protocol commands. only the shared commands read it, the protocol-specific ones always using their own backend. auto, the default, picks the first configured backend the command supports; an explicit value bails when the account has no such block, or the command no such implementation 😭

possible values:

  • auto: let the command pick the first backend it is configured for
  • imap: pin the command to the account's IMAP backend
  • jmap: pin the command to the account's JMAP backend
  • gmail: pin the command to the account's Gmail backend
  • msgraph: pin the command to the account's Microsoft Graph backend
  • maildir: pin the command to the account's Maildir backend
  • m2dir: pin the command to the account's m2dir backend
  • mbox: pin the command to the account's mbox backend
  • pimdir: pin the command to the account's pimdir backend
  • smtp: pin the command to the account's SMTP backend
  • sieve: pin the command to the account's ManageSieve backend
  • --json — enable JSON output. when set, command output (data or errors) is displayed as JSON string 🧚 machine-readable and iconic.
  • --log-level <LEVEL> — filter log output by level. when omitted, the RUST_LOG environment variable is consulted (it supports per-target filters — see the env_logger documentation). when present, this flag overrides RUST_LOG entirely 👑

possible values:

  • off: no logging
  • error: errors only
  • warn: warnings and errors
  • info: informational messages and above
  • debug: debug messages and above
  • trace: trace messages and above (most verbose) 🔍
  • --log-file <PATH> — append log output to the given file instead of stderr. useful when interactive prompts (which always write to stderr) would otherwise be intermixed with log lines 🫶 the file is opened in append mode and created if it does not exist.
  • -h, --help — print help (see a summary with -h) ✨
  • -V, --version — print version 🎀

🦋 SUBCOMMANDS 🦋

🌈 EXTRA 🌈

report bugs to:

https://github.com/pimalaya/himalaya/issues/

sponsoring:

https://pimalaya.org/sponsor/

this program is part of Pimalaya, free software funded entirely by grants and donations 💜 if you find it useful, consider sponsoring its development. that's the whole vibe — support your fave 🫶

⭐ VERSION ⭐

vv2.2.1 +vendored +gmail +jmap +msgraph +rustls-ring +maildir +mbox
+pimdir +imap +sieve +smtp build: linux gnu x86_64 git: unknown, rev
unknown

👑 AUTHORS 👑

Clément DOUIN (soywod) <pimalaya.org@posteo.net> 💖

and that's a wrap, bestie 🎀 this was himalaya(1) from the General Commands Manual, source/version himalaya 2.2.1 — go manage those emails, main character energy only 💅✨

📦 where this page comes from