Skip to content

Fix himalaya skill for CLI v1.2.0 (search DSL, move/copy arg order, editor traps) #2

@mattmezza

Description

@mattmezza

The himalaya CLI is now installed at ~/.local/bin/himalaya (v1.2.0; also in Arch extra via sudo pacman -S himalaya). Config cli-configs/himalaya.toml is already in modern v1.x format — no migration needed.

skills/himalaya-email.md is written against an older himalaya and has command bugs. Update it to match v1.2.0.

Bugs to fix in the skill

  • Search uses removed raw-IMAP syntax. -- "subject invoice" / -- "not flag seen" no longer work. v1.x uses a positional query DSL (no --): conditions date/before/after/from/to/subject/body/flag, operators not/and/or, order by <date|from|to|subject> [asc|desc].
    • Unread list: himalaya envelope list -a personal -o json "not flag seen"
  • message move/copy arg order is reversed. Real syntax is TARGET first: himalaya message move Archives 123 (skill currently has move 123 "Archives"). -f is the SOURCE folder.
  • Forward via heredoc <<< is wrong. message read/reply/forward/write/edit all open $EDITOR interactively — not automation-safe. Use the non-interactive template path piped into send.

Feature areas to cover (verified commands)

  • Read single: himalaya message read -a personal 123 (auto-marks Seen; -p/--preview to avoid)
  • Mark read/unread: flag add 123 Seen / flag remove 123 Seen
  • Delete single: message delete 123 (moves to Trash)
  • Mark spam: no spam flag — message move Spam 123 (run folder list for exact name)
  • Unread list: envelope list -o json "not flag seen"
  • Search: query DSL above
  • Reply (+ reply-all -A): himalaya template reply -a personal -A 123 "body" | himalaya template send -a personal
  • Send new: printf 'From:...\nTo:...\nSubject:...\n\nbody\n' | himalaya message send -a personal
  • Forward: himalaya template forward -a personal 123 "FYI" | himalaya template send -a personal

Also check

  • Config inconsistency: IMAP auth reads $MAIL_MEROLA_CO_APP_PASSWORD, SMTP reads $HIMALAYA_PERSONAL_PASSWORD — confirm both env vars are set or sending breaks.

The fully corrected skill markdown was drafted already — drop it into skills/himalaya-email.md.

Metadata

Metadata

Assignees

No one assigned

    Labels

    bugSomething isn't workingdocumentationImprovements or additions to documentation

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions