proton-maillisted

# Proton Mail (via Proton Bridge) Read and search Proton Mail from the command line through the locally running Proton Bridge app, which exposes a standard IMAP server (`127.0.0.1:1143`) over STARTTLS. All work goes through one helper: `scripts/proton_mail.py`. This skill is **read-only** by design: it lists, searches, and reads messages. It does not send, delete, move, or flag mail. ## Prerequisites (check before any operation) 1. Proton Bridge must be running. Quick check: pgrep -af protonmail-bridge If nothing prints, tell the user to start it (it is a desktop/tray app): protonmail-bridge --no-window & 2. Credentials file `~/.proton-imap` must exist with KEY=VALUE lines: PROTON_IMAP_USER=you@proton.me PROTON_IMAP_PASS=<bridge-generated password> PROTON_IMAP_HOST=127.0.0.1 PROTON_IMAP_PORT=1143 The password is the **bridge-specific** password shown in the Proton Bridge app under "Mailbox details", NOT the Proton account password. The file should be `chmod 600`. If it is missing, ask the user for the bridge username and password (or have them run `protonmail-bridge --cli` then `info`), then write the file yourself with `umask 077`. ## Usage Run the helper with `python3` (stdlib only, no deps): python3 scripts/proton_mail.py <subcommand> [options] Resolve the script path relative to this SKILL.md if the client exposes the skill directory; otherwise use the absolute path `~/Documents/Project/AI_Proje