Agent skill

c-email

Read, send, search, and label email via gog (Gmail CLI) or himalaya (IMAP). Supports inbox management, drafting replies, thread viewing, and label/folder operations across Gmail and standard IMAP accounts.

View SKILL.md on GitHub Repository
Stars 105
Forks 3

Install this agent skill to your Project

npx add-skill https://github.com/daxaur/openpaw/tree/main/skills/c-email

SKILL.md

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

Gmail — gog mail (gogcli)

bash
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

bash
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.

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

daxaur/openpaw

c-slack

Send messages and upload files to Slack channels using the `slack` CLI. Supports direct messages, channel posts, file uploads, and thread replies.

105 3
Explore
daxaur/openpaw

c-timer

Timers, alarms, and pomodoro — set countdowns with native notifications.

105 3
Explore
daxaur/openpaw

c-telegram

Bidirectional Telegram bridge — talk to Claude from your phone. Built into OpenPaw.

105 3
Explore
daxaur/openpaw

c-system

macOS Swiss Army Knife — control volume, wifi, battery, dock, display, trash, firewall, screensaver, shutdown, and more via m-cli.

105 3
Explore
daxaur/openpaw

c-tracking

Track packages across UPS, FedEx, USPS, and DHL using the `ordercli` CLI. Look up tracking numbers, get current status, estimated delivery dates, and shipment history without visiting carrier websites.

105 3
Explore
daxaur/openpaw

c-network

DNS lookups with doggo and readable HTTP requests with httpie — modern networking tools for the terminal.

105 3
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results