Himalaya

Himalaya CLI: почта через IMAP/SMTP из терминала.

Метаданные навыка

Справочник: полный SKILL.md

Himalaya Email CLI

Himalaya — консольный почтовый клиент для управления почтой из терминала; поддерживает бэкенды IMAP, SMTP, Notmuch и Sendmail.

Этот навык — не то же самое, что почтовый адаптер шлюза Hermes. Адаптер шлюза позволяет людям писать агенту по почте и использует встроенный в Hermes адаптер IMAP/SMTP; этот навык позволяет агенту самому управлять почтовым ящиком через инструменты терминала и требует внешний CLI himalaya.

Справочные материалы

• references/configuration.md (настройка конфигурационного файла + аутентификация IMAP/SMTP)
• references/message-composition.md (синтаксис MML для составления писем)

Требования

1. Himalaya CLI установлен (проверьте: himalaya --version)
2. Конфигурационный файл по пути ~/.config/himalaya/config.toml
3. Настроенные учётные данные IMAP/SMTP (пароль хранится безопасно)

Установка

# Готовый бинарник (Linux/macOS — рекомендуется)
curl -sSL https://raw.githubusercontent.com/pimalaya/himalaya/master/install.sh | PREFIX=~/.local sh

# macOS через Homebrew
brew install himalaya

# Или через cargo (любая платформа с Rust)
cargo install himalaya --locked

Настройка конфигурации

Запустите интерактивный мастер для настройки учётной записи:

himalaya account configure

Либо создайте ~/.config/himalaya/config.toml вручную:

[accounts.personal]
email = "you@example.com"
display-name = "Your Name"
default = true

backend.type = "imap"
backend.host = "imap.example.com"
backend.port = 993
backend.encryption.type = "tls"
backend.login = "you@example.com"
backend.auth.type = "password"
backend.auth.cmd = "pass show email/imap"  # или используйте keyring

message.send.backend.type = "smtp"
message.send.backend.host = "smtp.example.com"
message.send.backend.port = 587
message.send.backend.encryption.type = "start-tls"
message.send.backend.login = "you@example.com"
message.send.backend.auth.type = "password"
message.send.backend.auth.cmd = "pass show email/smtp"

# Псевдонимы папок (синтаксис himalaya v1.2.0+). Нужны, когда имена папок
# на сервере не совпадают с каноническими именами himalaya
# (inbox/sent/drafts/trash). Gmail — самый распространённый случай; маппинг
# `[Gmail]/Sent Mail` см. в `references/configuration.md`.
folder.aliases.inbox = "INBOX"
folder.aliases.sent = "Sent"
folder.aliases.drafts = "Drafts"
folder.aliases.trash = "Trash"

Внимание: синтаксис псевдонимов. В документации до v1.2.0 использовался под-раздел [accounts.NAME.folder.alias] (с alias в единственном числе). Версия v1.2.0 молча игнорирует эту форму — TOML разбирается без ошибок, но резолвер псевдонимов её не читает, и каждый поиск откатывается к каноническому имени. На Gmail это значит, что сохранение в Sent падает после успешной доставки по SMTP, а himalaya message send завершается с ненулевым кодом. Любой вызывающий (агент, скрипт, пользователь), который повторяет попытку при таком коде выхода, заново прогонит всю отправку — включая SMTP — и получатели получат дублирующиеся письма. Всегда используйте folder.aliases.X (множественное число, точечные ключи, прямо под [accounts.NAME]).

Заметки об интеграции с Hermes

• Чтение, перечисление, поиск, перемещение, удаление — всё работает напрямую через инструмент терминала
• Составление, ответ, пересылка — рекомендуется передавать ввод через конвейер (cat << EOF | himalaya template send): надёжнее. Интерактивный режим $EDITOR тоже работает с pty=true + фоновым запуском + инструментом процессов, но нужно знать редактор и его команды
• Используйте --output json для структурированного вывода, который проще разбирать программно
• Мастер himalaya account configure требует интерактивного ввода — запускайте в режиме PTY: terminal(command="himalaya account configure", pty=true)

Частые операции

Список папок

himalaya folder list

Список писем

Список писем в INBOX (по умолчанию):

himalaya envelope list

Список писем в конкретной папке:

himalaya envelope list --folder "Sent"

Список с постраничной разбивкой:

himalaya envelope list --page 1 --page-size 20

Поиск писем

himalaya envelope list from john@example.com subject meeting

Чтение письма

Прочитать письмо по ID (показывает обычный текст):

himalaya message read 42

Экспортировать сырой MIME:

himalaya message export 42 --full

Ответ на письмо

Чтобы ответить из Hermes без интерактива, прочитайте исходное сообщение, составьте ответ и передайте его по конвейеру:

# Получить шаблон ответа, отредактировать и отправить
himalaya template reply 42 | sed 's/^$/\nYour reply text here\n/' | himalaya template send

Либо соберите ответ вручную:

cat << 'EOF' | himalaya template send
From: you@example.com
To: sender@example.com
Subject: Re: Original Subject
In-Reply-To: <original-message-id>

Your reply here.
EOF

Ответ всем (интерактивный — нужен $EDITOR; лучше используйте подход с шаблоном выше):

himalaya message reply 42 --all

Пересылка письма

# Получить шаблон пересылки и передать с изменениями по конвейеру
himalaya template forward 42 | sed 's/^To:.*/To: newrecipient@example.com/' | himalaya template send

Написать новое письмо

Без интерактива (используйте из Hermes) — передайте сообщение через stdin:

cat << 'EOF' | himalaya template send
From: you@example.com
To: recipient@example.com
Subject: Test Message

Hello from Himalaya!
EOF

Либо через флаг заголовков:

himalaya message write -H "To:recipient@example.com" -H "Subject:Test" "Message body here"

Примечание: himalaya message write без ввода по конвейеру открывает $EDITOR. С pty=true + фоновым режимом тоже работает, но конвейер проще и надёжнее.

Перемещение/копирование писем

Переместить в папку (сначала целевая папка, затем ID письма):

himalaya message move "Archive" 42

Скопировать в папку (сначала целевая папка, затем ID письма):

himalaya message copy "Important" 42

Удаление письма

himalaya message delete 42

Управление флагами

Добавить флаг:

himalaya flag add 42 --flag seen

Снять флаг:

himalaya flag remove 42 --flag seen

Несколько учётных записей

Список учётных записей:

himalaya account list

Использовать конкретную учётную запись:

himalaya --account work envelope list

Вложения

Сохранить вложения из сообщения:

himalaya attachment download 42

Сохранить в указанную директорию:

himalaya attachment download 42 --downloads-dir ~/Downloads

Форматы вывода

Большинство команд поддерживают --output для структурированного вывода:

himalaya envelope list --output json
himalaya envelope list --output plain

Отладка

Включить отладочное логирование:

RUST_LOG=debug himalaya envelope list

Полная трассировка с бэктрейсом:

RUST_LOG=trace RUST_BACKTRACE=1 himalaya envelope list

Советы

• Подробную справку смотрите через himalaya --help или himalaya <command> --help.
• ID сообщений привязаны к текущей папке; после смены папки обновите список.
• Для составления писем с вложениями используйте синтаксис MML (см. references/message-composition.md).
• Храните пароли безопасно: через pass, системный keyring или команду, которая выводит пароль.