Email Assistant
Apps & Automationemail-assistantEmail Assistant is an Agent Skill for apps & automation published in the fuyuxiang/echo-agent repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Read, search, draft, and send emails via Himalaya CLI or Python IMAP/SMTP. Requires email account configuration.
QUICK START
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/fuyuxiang/echo-agent/blob/HEAD/skills/productivity/email-assistant/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/email-assistant, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
Email Assistant
Two options: Himalaya CLI (modern, Rust-based) or Python imaplib fallback.
Option A: Himalaya (Recommended)
brew install himalaya # or cargo install himalaya
himalaya account configure
Read
himalaya envelope list
himalaya envelope list --folder INBOX --page-size 10
himalaya message read <id>
Search
himalaya envelope list --folder INBOX subject "weekly report"
himalaya envelope list from "[email protected]"
Send
himalaya message write
# Or via template:
himalaya template write | himalaya message send
Reply/Forward
himalaya message reply <id>
himalaya message forward <id>
Option B: Python Fallback
Environment variables:
export ECHO_EMAIL_HOST=imap.gmail.com
export [email protected]
export ECHO_EMAIL_PASS=app-password
export ECHO_SMTP_HOST=smtp.gmail.com
export ECHO_SMTP_PORT=587
python3 scripts/email_client.py list --host imap.example.com --user [email protected] --password xxx --count 10
python3 scripts/email_client.py search --host imap.example.com --user [email protected] --password xxx "urgent"
python3 scripts/email_client.py send --smtp-host smtp.example.com --user [email protected] --password xxx --to "[email protected]" --subject "Hi" --body "Content"
Common Workflows
- Morning email digest: fetch unread, summarize subjects
- Draft reply: compose response based on context
- Search by sender/date/subject
Security
- Store credentials in environment variables, never in chat
- Use app-specific passwords (Gmail requires this)
- Consider OAuth2 for production use