From 61144eb43e16b32c33c3e033b388f2e65f9c2e74 Mon Sep 17 00:00:00 2001
From: Alexander Payne <alex@alexanderwhitestone.com>
Date: Thu, 30 Apr 2026 09:43:42 -0400
Subject: [PATCH] feat(email): add himalaya config for
 alexander@alexanderwhitestone.com

- Add config/himalaya/config.toml with IMAP/SMTP to Stalwart
- Reference EMAIL_PASSWORD via env var (keeps secret out of VCS)
- Create .env.example documenting EMAIL_PASSWORD for hermes .env

This sets up terminal email on Mac. After brew install himalaya:
  1. Copy config/himalaya/config.toml to ~/.config/himalaya/config.toml
  2. Export EMAIL_PASSWORD (or add to ~/.hermes/.env)
  3. Run: himalaya envelope list  # verify inbox
     himalaya message send --to you@example.com "test"

Closes #321
---
 .env.example                |  7 +++++++
 config/himalaya/config.toml | 25 +++++++++++++++++++++++++
 2 files changed, 32 insertions(+)
 create mode 100644 .env.example
 create mode 100644 config/himalaya/config.toml

diff --git a/.env.example b/.env.example
new file mode 100644
index 00000000..bc367649
--- /dev/null
+++ b/.env.example
@@ -0,0 +1,7 @@
+# Hermes environment variables
+# Copy this file to .env and fill in real values.
+# DO NOT commit .env — it is gitignored.
+
+# Email credentials for himalaya terminal client
+# Stalwart Mail Server at mail.alexanderwhitestone.com
+EMAIL_PASSWORD=changeme
diff --git a/config/himalaya/config.toml b/config/himalaya/config.toml
new file mode 100644
index 00000000..f26a0f8f
--- /dev/null
+++ b/config/himalaya/config.toml
@@ -0,0 +1,25 @@
+# Himalaya configuration for Timmy Foundation email
+# Access alexander@alexanderwhitestone.com via Stalwart Mail Server
+#
+# This config references EMAIL_PASSWORD environment variable so that
+# the actual secret is not stored in version control.
+#
+# After copying this file to ~/.config/himalaya/config.toml, ensure
+# EMAIL_PASSWORD is set in the environment (or in ~/.hermes/.env).
+# Then verify:
+#   himalaya envelope list          # should show inbox
+#   himalaya message send --to you@example.com "test"
+
+[imap]
+host = "mail.alexanderwhitestone.com"
+port = 993
+ssl = true
+username = "alexander@alexanderwhitestone.com"
+password_env = "EMAIL_PASSWORD"
+
+[smtp]
+host = "mail.alexanderwhitestone.com"
+port = 465
+ssl = true
+username = "alexander@alexanderwhitestone.com"
+password_env = "EMAIL_PASSWORD"