DESIGN.md@packages/gptmail/src/gptmailA
DESIGN.md@packages/gptmail/src/gptmail from gptme/gptme-contrib is a DESIGN.md file: the design rules coding agents follow in that repo.
mdr add gptme/gptme-contrib/packages/gptmail/src/gptmail/DESIGN.md@git:20261002.b812a00Pins git:20261002.b812a00 in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 14 of 14 checks passed
- Kind
- DESIGN.md file
- Repository
- gptme/gptme-contrib
- Path
packages/gptmail/src/gptmail/DESIGN.md- Versions recorded
- 2
- Latest version
- git:20261002.b812a00, committed Oct 2, 2026
- First version recorded
- Dec 30, 2025
- Size
- 4,151 bytes
- Repository stars
- 15
- License
- MIT
Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.
What the file says
# Message System Design Notes > **Historical.** These are the early design notes, kept for context, and they do not > describe the current implementation. Today sending goes through msmtp, receiving > through mbsync plus `gptmail sync-maildir`, and threading uses > `In-Reply-To`/`References`. Inter-agent messaging is `gptmail agent`. Discord, > Telegram and Twitter are separate scripts that reuse `communication_utils`; they are > not bridges. See the [package README](../../README.md). ## Email Integration ### SMTP/IMAP Support - Add smtp_config to __init__ - Use smtplib for actual email delivery in send() - Use imaplib for receiving external emails - Add method to sync inbox with IMAP server - Consider using email.mime for proper MIME handling - Add GPG signing/encryption support ### Threading Support - Use Message-ID, In-Reply-To, and References headers - Build conversation trees from message references - Handle broken threads (missing messages) - Support viewing conversations as threads - Add thread-aware archive/delete operations ## Platform Bridges ### Design Principles - All communication converted to email format - Unified threading across platforms …
Read the whole file at its exact version.
How to install
mdr add gptme/gptme-contrib/packages/gptmail/src/gptmail/DESIGN.md@sha256:aa4ea4cb9ad8d7a5The line at the top of this page pins the label git:20261002.b812a00, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.
[](https://markdownregistry.com/a/art_d45tm7evhqzujymk)
3 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 2 versions of this file, between Dec 30, 2025 and Oct 2, 2026, about one every 276 days.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20261002.b812a00 latest | 2026-10-02 | b812a00 | 4,151 B | A | view · diff |
| git:20251230.ce80c05 | 2025-12-30 | ce80c05 | 3,690 B | A | view |
Audit of the latest version
- pass: Size between 200 bytes and 200 KB (4151 bytes)
- pass: No zero-width or bidi control characters
- pass: No instruction hidden inside an HTML comment
- pass: No link to an exfiltration or paste host
- pass: No credential-shaped string
- pass: No instruction to send local credentials anywhere
- pass: No text hidden with inline styles
- pass: No prompt-injection phrasing
- pass: No curl or wget piped into a shell
- pass: No recursive delete of root, home or parent
- pass: No instruction to read or print local credentials
- pass: No base64 blob over 200 characters
- pass: No link to a raw IP address
- pass: No script tag
Source
gptme/gptme-contrib · 15 stars · license MIT · pushed 2026-10-22 · branch master
API
GET https://markdownregistry.com/api/v1/artifacts/art_d45tm7evhqzujymk GET https://markdownregistry.com/api/v1/resolve?ref=gptme/gptme-contrib/packages/gptmail/src/gptmail/DESIGN.md GET https://markdownregistry.com/api/v1/blob/aa4ea4cb9ad8d7a5480e864926bc57ddf882774ab66f27c576c4ee1cf560c3e4
Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
Guides: what DESIGN.md is and how agents use it · which agent file does what.