himalaya

IMAP/SMTP mail client following the pimalaya/himalaya vocabulary. Install it on the workspace and the whole tree is discoverable with himalaya --help.

Install

from mirage import Workspace
from mirage.commands.cli.builtin.himalaya import HIMALAYA
from mirage.core.email.config import EmailConfig
from mirage.resource.email import EmailResource

config = EmailConfig(
    imap_host="imap.example.com",
    smtp_host="smtp.example.com",
    username="agent@example.com",
    password="app-password",
)
ws = Workspace({"/mail": EmailResource(config)})
ws.register_cli("himalaya", HIMALAYA, config.model_dump())

Two installs under different names are two accounts. In YAML, the same install rides the clis: section; see the CLI overview.

Verbs

The verbs follow the himalaya CLI structure (himalaya envelope ..., himalaya message ...) and return JSON rather than opening an interactive editor.

`himalaya envelope list`

List and triage messages in a folder.

himalaya envelope list --folder INBOX --unseen --max 10

Option	Required	Description
`--folder`	no	IMAP folder (default: INBOX)
`--max`	no	Max results (default: 20)
`--unseen`	no	Only show unread messages
`--subject`	no	Filter by subject text
`--from`	no	Filter by sender
`--to`	no	Filter by recipient
`--body`	no	Filter by body text
`--since`	no	Only messages since this date
`--before`	no	Only messages before this date

`himalaya message read`

himalaya message read --uid 12345 --folder INBOX

Option	Required	Description
`--uid`	yes	Message UID
`--folder`	yes	IMAP folder

`himalaya message send`

himalaya message send --to "user@example.com" --subject "Hello" --body "Hi there"

Option	Required	Description
`--to`	yes	Recipient email address
`--subject`	yes	Email subject line
`--body`	yes	Email body text

`himalaya message reply`

Pass --all to reply to every recipient (To and CC).

himalaya message reply --uid 12345 --folder INBOX --body "Thanks for the update"
himalaya message reply --uid 12345 --folder INBOX --body "Acknowledged" --all

Option	Required	Description
`--uid`	yes	Message UID
`--folder`	yes	IMAP folder
`--body`	yes	Reply body text
`--all`	no	Reply to all recipients (To + CC)

`himalaya message forward`

himalaya message forward --uid 12345 --folder INBOX --to "colleague@example.com"

Option	Required	Description
`--uid`	yes	Message UID
`--folder`	yes	IMAP folder
`--to`	yes	Recipient email address

Getting Started

Agents

Resources

CLIs

Watch

Runtimes

Install

Verbs

`himalaya envelope list`

`himalaya message read`

`himalaya message send`

`himalaya message reply`

`himalaya message forward`

​Install

​Verbs

​himalaya envelope list

​himalaya message read

​himalaya message send

​himalaya message reply

​himalaya message forward

Install

Verbs

`himalaya envelope list`

`himalaya message read`

`himalaya message send`

`himalaya message reply`

`himalaya message forward`