C Email

This skill manages email via gog (Gmail) or himalaya (IMAP). Check availability with which gog himalaya.

Gmail — gog mail (gogcli)

gog mail list                              # List inbox messages
gog mail list --label "INBOX" --max 20
gog mail read <message-id>                 # Read a message
gog mail send --to "user@example.com" --subject "Subject" --body "Body"
gog mail reply <message-id> --body "Reply text"
gog mail search "from:alice subject:report"
gog mail search "is:unread after:2026/02/01"
gog mail label add <message-id> "Label"
gog mail label remove <message-id> "INBOX"
gog mail archive <message-id>
gog mail trash <message-id>
gog mail labels                            # List all labels
gog mail thread <thread-id>                # View full thread

IMAP — himalaya

himalaya list                              # List inbox
himalaya list -m 50                        # List last 50 messages
himalaya read <id>                         # Read message
himalaya write                             # Compose new message (interactive)
himalaya send --to "user@example.com" --subject "Subj" < body.txt
himalaya reply <id>
himalaya forward <id>
himalaya search "subject:report"
himalaya move <id> "Archive"               # Move to folder
himalaya delete <id>
himalaya folders                           # List folders
himalaya --account work list               # Use a specific account

Usage Guidelines

• Prefer gog for Gmail accounts; prefer himalaya for non-Gmail IMAP.
• Use gog mail search with Gmail search syntax (from:, to:, subject:, is:unread, has:attachment).
• For sending with body content, pass the body directly or pipe a file.
• Both tools require prior authentication setup.

Notes

• gog requires Google OAuth configured via gog auth.
• himalaya requires IMAP credentials in ~/.config/himalaya/config.toml.