email-notify 的用途是在 Codex 每次任务完成后发送一封电子邮件通知,让用户及时了解运行结果。主要能力包括:通过 SMTP 发送邮件、自动解析项目名称(若未指定则回退到项目文件夹名),并支持在邮件中携带任务标题、执行状态和结果摘要。
使用前需配置环境变量,可写入 ~/.bashrc(Linux)或 ~/.zshrc(macOS),包括 CODEX_MACHINE_NAME、CODEX_EMAIL_SMTP_HOST、CODEX_EMAIL_SMTP_PORT、CODEX_EMAIL_USERNAME、CODEX_EMAIL_PASSWORD、CODEX_EMAIL_FROM、CODEX_EMAIL_TO、CODEX_EMAIL_USE_TLS、CODEX_EMAIL_USE_SSL。若 SMTP 服务器无需认证,可不设置用户名和密码;SMTPS 通常端口 465 设 CODEX_EMAIL_USE_SSL 为 true,STARTTLS 则设 CODEX_EMAIL_USE_TLS 为 true,两者不可同时为 true。
通常还需在项目 AGENTS.md 中加入指令,提示在每次 agent 运行结束或需要通知用户时使用 email-notify。项目名称可选用 YAML frontmatter 的 project_name/name,或用一行“Project Name:”指定,否则使用文件夹名。
任务完成时,生成简短任务标题(3-8 个词)、选择执行状态(如 success、failed、partial、blocked 等)、撰写简要结果摘要(避免包含敏感信息),然后运行:
python3 ~/.codex/skills/email-notify/scripts/send_email_notification.py
--task-title "..."
--status "success"
--summary "..."
--project-name "..."
适用场景为需要在 Codex 或 Claude 单次运行结束时获得邮件提醒的用户。限制方面,资料未提供收费、价格、平台兼容范围或邮件送达保证等信息。