agent-email-cli

エージェントメール CLI

概要

受信トレイへのアクセスが必要なエージェントのワークフローで、agent-email コマンドを安全かつ予測可能に操作するには、このスキルを使用してください。

JSON ネイティブのコマンド出力を優先し、要約には主要なフィールド（email、messageId、subject、createdAt、from.address）を含めてください。

ワークフロー

1. CLI が利用可能か確認します。

command -v agent-email
agent-email --help

見つからない場合は、インストールします。

npm install -g @zaddy6/agentemail
# or
bun install -g @zaddy6/agentemail

2. メールボックスアカウントを作成します。

agent-email create

JSON 出力から次のフィールドを記録します。

• data.email
• data.accountId
• data.activeEmail

メールボックスのパスワードやトークンなどのシークレット値を記録、転載、表示しないでください。

3. 最新のメッセージを読み取ります。

agent-email read <email|default>

受信トレイの待機／ポーリングには、次を使用します。

agent-email read <email|default> --wait 30 --interval 2

メッセージの完全なペイロードには、次を使用します。

agent-email read <email|default> --full

4. 1 件のメッセージを詳しく取得します。

agent-email show <email|default> <messageId>

確認リンク、コード、またはコンテンツ全体の抽出にあたり、本文やソースの詳細が必要な場合は、show を使用します。

5. メールボックスのプロファイルを管理します。

agent-email accounts list
agent-email use <email|default>
agent-email accounts remove <email>

エージェントのログにシークレットを入力する必要があるコマンドは避けてください。

6. 要求された場合は、処理済み／不要なメッセージを削除します。

agent-email delete <email|default> <messageId>

運用ガイダンス

• コマンド出力は機械可読な状態に保ち、要求されない限り人間向けの出力を強制しないでください。
• ユーザーがメールアドレスを指定しない場合は、default エイリアスを優先してください。
• コマンド出力のシークレット値（password、token）を表示、保存、要約しないでください。
• コマンドが失敗した場合は、JSON の code および hint フィールドをそのまま提示してください。
• 認証エラー（AUTH_REQUIRED／401）の場合は、コマンドを一度だけ再実行し、認証情報の再設定が必要であればユーザーに対応を依頼してください。
• レート制限（RATE_LIMITED／429）の場合は、少し待ってから再試行してください。

トラブルシューティング

• command not found：~/.bun/bin または npm のグローバル bin パスが PATH に含まれていることを確認してください。
• NO_ACTIVE_ACCOUNT：agent-email create または agent-email use <email> を実行してください。
• ACCOUNT_NOT_FOUND：agent-email accounts list を実行し、有効なアドレスを選択してください。
• npm の公開時に EOTP が発生した場合：CI では npm trusted publishing を使用するか、OTP を使用してローカルで公開してください。

参考資料

• コマンドのチートシートと JSON フィールドの一覧については、references/commands.md をお読みください。