EmailingEssay

AI-driven essay delivery — proactive communication born from genuine reflection.

Quick Start

File	For	Content
README.md	Everyone	Quick start & glossary (this file)
SETUP.md	First-time users	Environment setup
CONCEPT.md	Curious minds	Philosophy & design rationale
CLAUDE.md	AI/Architects	Architecture overview
CONTRIBUTING.md	Contributors	Development workflow
commands/essay.md	Users	Command reference
agents/essay-writer.md	AI	Agent specification
skills/reflect/SKILL.md	AI	Reflection skill
skills/send-email/SKILL.md	AI	Email sending skill

Key terms used throughout this plugin:

Term	Definition
theme	Essay topic or subject provided via `-t` or `--theme` option
context_files	Reference files for reflection, provided via `-f` or `--file` option
mode	Execution mode: `wait` (one-time), `schedule` (recurring), or `test`
frequency	Schedule interval: `daily`, `weekly`, `monthly`, `quarterly`, `half_yearly`, `yearly`, or `custom`
reflection	Deep thinking process before essay composition (uses UltraThink)
delivery decision	Conscious choice to send or not send (silence is meaningful)
ledger	Append-only record of every sent essay, keyed by `message_id`
reply ingestion	Pulling back the replies to sent essays, matched by `In-Reply-To`

Command	Description
`/essay`	Immediate reflection (output to chat)
`/essay wait <time>`	One-time scheduled delivery
`/essay schedule <frequency>`	Recurring scheduled delivery
`/essay schedule list`	List all registered schedules
`/essay schedule remove <name>`	Remove a registered schedule
`/essay test`	Test email configuration

Sends are recorded on their own. Replies are pulled back through the script CLI:

python main.py replies fetch    # Ingest replies to sent essays
python main.py replies list     # List ingested replies

A body of more than one paragraph is sent from a file, not from the command line:

python main.py send --subject-file s.txt --body-file b.txt

See skills/send-email/SKILL.md for the round trip (Correspondence Paths) and file locations.