pip install mailcode

通过邮件远程操控
AI Agent

将你的邮箱收件箱变成 AI Agent 的远程控制台。MailCode 打通 OpenCode 和 Claude Code——通过任意邮箱收发任务、注入指令、接收结果。零第三方依赖,一条命令完成安装。

为什么选择 MailCode

为需要随时随地掌控 AI Agent 的开发者而生。

定时任务引擎

类 Cron 的邮件调度系统——定时备份、每日报告、自动化代码审查,全自动完成。

0 9 * * * 执行每日代码审查
💬

终端聊天

直接从终端启动交互式 REPL 与 AI 对话——无需经过邮件。可恢复中继服务中创建的任何会话,或开启全新对话。

mailcode chat --session-id <id>
📁

会话持久化

每个对话以独立文件持久化存储,可在 serve 和 chat 模式间无缝切换。重启后自动恢复,支持按 TTL 自动清理过期会话。

mailcode session list
🛡️

多重安全防护

DKIM/SPF 域名认证、发件人白名单、命令黑名单、会话自动过期——每封邮件执行前均经过验证。

企业级安全保护

双模式运行

Session 模式支持持久化多轮对话 + 无状态模式支持单次命令。Session 模式下工作目录(cwd)可粘性保持。

Session · 无状态
🌐

主流邮箱支持

Gmail、Outlook、QQ 邮箱、126 邮箱——IMAP IDLE 长连接,指令秒级送达。

Gmail · Outlook · QQ · 126

工作原理

MailCode 在邮箱收件箱与 AI Agent 之间搭建了一座简单的桥梁。

✉️

发送邮件

从手机、平板或笔记本发送编程任务或指令到你的邮箱。

📡

IMAP 实时监听

MailCode 通过 IMAP IDLE 长连接实时监听收件箱,新邮件秒级响应。

AI 处理

命令转发给 claude -p 子进程处理。AI 执行任务并流式返回结果。

📬

结果通知

任务完成后自动发送回复邮件。回复该邮件即可继续对话。

两种使用模式

选择多轮对话或单次命令——总有一种适合你的工作流。

Session 模式

多轮对话

MailCode 按邮件主题将对话分组为持久化 Session。回复同一邮件主题,AI 会记住上下文——无需重复描述。工作目录(cwd)具有粘性:首封邮件设置后,后续回复自动沿用。Session 在重启后仍可恢复,也可通过 mailcode chat --session-id <id> 在终端中继续。

首封邮件: cwd: ~/Projects/my-app 给登录模块添加错误处理 继续回复——AI 记得上下文: 再为这些错误处理写单元测试
无状态模式

单次命令

在配置中设置 session.enabled = false 即可切换为简单的一问一答模式。每封邮件独立处理,不保留对话历史。cwd 指令每次重新解析。适合定时任务或一次性查询。

邮件——不保留上下文: cwd: ~/Projects/my-app 运行测试套件并报告失败项

支持所有主流邮箱

配置 SMTP 和 IMAP 即可连接你的邮箱。

真实场景

开发者用 MailCode 随时随地与代码保持连接。

🚀

移动端开发

通勤或离开工位时,用手机发送邮件即可触发 AI 编程。审查结果并继续迭代——全程口袋操作。

🔄

定时自动化

配置类 Cron 邮件调度,实现定时数据库备份、依赖更新、代码重构——无需时刻开着电脑。

🔗

远程协作

出差途中遇到线上问题?发送邮件包含热修复命令。MailCode 远程启动 Agent 执行补丁并返回结果。

开源

MailCode 基于 MIT 协议完全开源——任何人可自由使用、修改、分发。
欢迎在 GitHub 上提交 Issue、Star 或贡献代码。

一条命令完成安装

需要 Python 3.9+ 和一个 AI Agent CLI(Claude Code 或 OpenCode)。

pip install mailcode
mailcode config init
mailcode serve

运行 mailcode config init 配置邮箱,然后启动中继服务 mailcode serve

准备好远程操控你的 AI Agent 了吗?

一条命令安装 MailCode,几分钟内将你的邮箱与 AI 打通。完全免费开源。

开源 · MIT 协议 · Python 3.9+