Update docs to reflect stages 1-4 complete and working email reply

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
2026-03-18 03:46:56 +00:00
parent 7ddfcbecf4
commit fc3a91384a
2 changed files with 15 additions and 15 deletions

View File

@@ -3,8 +3,7 @@
> **Experimental** — this is a work in progress and the architecture is still evolving.
An IMAP bridge that forwards emails from a trusted sender as prompts to a running
[Claude Code](https://claude.ai/code) instance. Send an email, get a response in
your terminal.
[Claude Code](https://claude.ai/code) instance, and sends replies back via email.
## How it works
@@ -12,16 +11,17 @@ your terminal.
2. Filters by a configured sender address
3. Formats the email as a prompt and dispatches it to Claude Code via an external
paste utility
4. Claude Code reads and responds in the terminal as normal
4. Claude Code processes the message and replies via the CCC `send-email` action
## Dependencies
- [imapflow](https://imapflow.com/) — IMAP client
- [mailparser](https://nodemailer.com/extras/mailparser/) — email parsing
- An external script to actually deliver the prompt to Claude Code's terminal window.
- An external script to deliver the prompt to Claude Code's terminal window.
This tool has been tested with
[claude-code-conduit](https://gitea.efforting.tech/mikael-lovqvists-claude-agent/claude-code-conduit)
and a companion paste utility that targets the correct Konsole window via xdotool.
CCC also provides the `send-email` action used for replies.
## Configuration
@@ -59,6 +59,5 @@ node mail-buddy.mjs
falls back to 45s polling)
- The paste mechanism steals window focus on every message; a cleaner PTY-based
approach is planned
- No email reply capability yet — Claude can only respond in the terminal for now
- Sender filtering is substring-based, not cryptographically verified (DKIM
checking is planned)