Hermes Agent Wiki 非公式・日本語wiki
この skill をそのまま使う: GitHub で原文を見る

英語原文・frontmatter 込みで、Hermes が読み込む実体そのままです（このページの本文は日本語版）。

Himalaya

目次

Himalaya CLI です。ターミナルから IMAP/SMTP のメールを扱います。

skill の情報
提供元 最初から入っています
パス skills/email/himalaya
バージョン 1.1.0
作者 community
ライセンス MIT
対応プラットフォーム linux, macos, windows
タグ Email, IMAP, SMTP, CLI, Communication

参考: SKILL.md 全文

Himalaya Email CLI

Himalaya はコマンドライン用のメールクライアントで、IMAP・SMTP・Notmuch・Sendmail のいずれかを使い、ターミナルからメールを扱えます。

この skill は、Hermes の Email ゲートウェイアダプターとは別物です。ゲートウェイ アダプターは、人がエージェントにメールを送れるようにするもので、Hermes に内蔵の IMAP/SMTP アダプターを使います。この skill は、エージェントがターミナルの道具で メールボックスを操作するためのもので、外部の himalaya CLI が必要です。

参考資料

  • references/configuration.md（設定ファイルの作り方と IMAP/SMTP の認証）
  • references/message-composition.md（メールを組み立てる MML の書き方）

事前に必要なもの

  1. Himalaya CLI が入っていること（himalaya --version で確認します）
  2. ~/.config/himalaya/config.toml に設定ファイルがあること
  3. IMAP/SMTP の認証情報が設定されていること（パスワードは安全な場所に置きます）

導入

# Pre-built binary (Linux/macOS — recommended)
curl -sSL https://raw.githubusercontent.com/pimalaya/himalaya/master/install.sh | PREFIX=~/.local sh

# macOS via Homebrew
brew install himalaya

# Or via cargo (any platform with 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"  # or use 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"

# Folder aliases (himalaya v1.2.0+ syntax). Required whenever the
# server's folder names don't match himalaya's canonical names
# (inbox/sent/drafts/trash). Gmail is the common case — see
# `references/configuration.md` for the `[Gmail]/Sent Mail` mapping.
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 ではこれが原因で、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 から対話なしで返信するには、元のメールを読み、返信を組み立てて、標準入力に流し込みます。

# Get the reply template, edit it, and send
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

メールを転送する

# Get forward template and pipe with modifications
himalaya template forward 42 | sed 's/^To:.*/To: newrecipient@example.com/' | himalaya template send

新しいメールを書く

対話なしの方法（Hermes からはこちらを使ってください） — メールを標準入力に流し込みます。

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、システムのキーリング、またはパスワードを出力するコマンドを使って安全に保管してください。