maddy
AGENTS.md6.1k starsChanged 5 years agoGPL-3.0View on GitHub
Maddy is a composable all-in-one mail server (MTA/MX/IMAP) written in Go. The core abstraction is the module system: every functional component (auth, storage, checks, targets, endpoints) implements module.Module from framework/module/module.go…
We split this AGENTS.md into the rules it gives an agent
9 rules. About 0 are common, 3 are distinctive, and 6 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈3
Distinctive · estimate
This author's own choices. Worth a look.
6
Very specific
Tied to their project's names, files or tools. Probably skip.
Licensed with conditions — read it at the source. We count its rules but don't quote them. Read them on GitHub.
≈ “Common” is an estimate: at least 1 in 5 of the 36,368 AGENTS.md files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Trending
Less talk lately.about the whole repository
Who's talking about foxcpp/maddy
- A Hacker News story“Maddy: Composable all-in-one mail server in Go”Hacker News · Nov 20, 2020 · 229 points
- A Hacker News story“Maddy – Composable all-in-one mail server”Hacker News · May 20, 2020 · 11 points
- golang/go“crypto/tls: interoperability problems between go tls server and microsoft/outlook.com tls (smtp starttls) …”GitHub · Nov 6, 2024 · 8 reactions
- A Hacker News story“Maddy: All-in-one mail server writen in Go”Hacker News · Jun 24, 2022 · 5 points
- A Hacker News story“Maddy: Composable all-in-one mail server”Hacker News · Jul 31, 2024 · 3 points
The biggest 5 of 55 mentions linking to the repository that our crawl found. Each line is their own headline.
See all 55
Talked about on GitHub, Hacker News and Bluesky (55 times).
On GitHub · 50
- Nov 6, 2024crypto/tls: interoperability problems between go tls server and microsoft/outlook.com tls (smtp starttls) client — golang/go8 reactions · 9 comments
- Oct 24, 2025Use official Maddy image when ARM support returns — mcsrobert/homelab2 reactions · 1 comment
- Jul 16, 2025Send and apply MDNs to self — chatmail/core2 reactions · 10 comments
- May 9, 2020Registering Email fails with "undefined method `[]' for nil:NilClass" — zammad/zammad2 reactions · 24 comments
- Jan 19, 2026Remove `sync_seen_flags()` eventually — chatmail/core1 reaction · 4 comments
45 more on GitHub
- Feb 7, 2025Invalid `NIL` in body encoding — modern-email/defects1 reaction · 1 comment
- Oct 27, 2026feat(container)!: Update image ghcr.io/foxcpp/maddy (0.8.2 ➔ 0.9.6) — fiqrimasngot/kube0 reactions
- Oct 3, 2026maddy: 0.9.5 -> 0.9.6 — NixOS/nixpkgs0 reactions · 1 comment
- Oct 3, 2026feat(container): update image ghcr.io/foxcpp/maddy to v0.9.6 — cftechwiz/homelab-ops0 reactions
- Oct 3, 2026fix(container): update image ghcr.io/foxcpp/maddy (0.9.5 → 0.9.6) — vrozaksen/home-ops0 reactions · 2 comments
- Oct 3, 2026fix(container): update image ghcr.io/foxcpp/maddy (0.9.5 ➔ 0.9.6) — drag0n141/home-ops0 reactions · 2 comments
- Aug 24, 2026feat!: swap parser backend from maddy cfgparser to coredns caddyfile — open-webtech/go-xaddy-config0 reactions
- Aug 3, 2026feat(container): update ghcr.io/foxcpp/maddy ( 0.8.1 → 0.9.5 ) — sob/home-ops0 reactions
- Jul 14, 2026Blitzy: maddy SMTP security investigation report — DATA boundary & auth-identity reuse — blitzy-research/maddy0 reactions
- Jul 13, 2026Blitzy: Add maddy runtime-logging onboarding Q&A documentation — blitzy-research/maddy0 reactions
- Jul 8, 2026Blitzy: maddy Message Pipeline & Delivery-Queue Runtime Behavioral Investigation (Q&A documentation) — blitzy-research/maddy0 reactions
- Jul 8, 2026Blitzy: Runtime investigation of Maddy SMTP DATA message-boundary detection & SMTP-smuggling behavior — blitzy-research/maddy0 reactions
- Jul 7, 2026Blitzy: Add maddy runtime logging & delivery onboarding Q&A — blitzy-research/maddy0 reactions
- Jul 1, 2026Blitzy: Runtime-observed analysis of maddy's SMTP DATA end-of-message boundary under adversarial line-ending framing — blitzy-research/maddy0 reactions
- Jul 1, 2026Blitzy: Empirical SMTP-Security Investigation of maddy (DATA lone-dot & auth identity across RSET) — blitzy-research/maddy0 reactions
- Jun 27, 2026Fix maddy GHSA affected range — github/advisory-database0 reactions · 1 comment
- Jun 24, 2026x/vulndb: potential Go vuln in github.com/foxcpp/maddy: GHSA-5835-4gvc-32pc — golang/vulndb0 reactions · 1 comment
- Jun 24, 2026feat(plugins): add 5 new bundled plugins — mockery, mailhog, xcaddy, hostctl, maddy — javimosch/supercli0 reactions · 5 comments
- Jun 21, 2026feat(container): update image ghcr.io/foxcpp/maddy to v0.9.5 — cftechwiz/homelab-ops0 reactions
- Jun 16, 2026[maddy] Update maddy — k8s-home-lab/helm-charts0 reactions
- May 1, 2026maddy: 0.8.2 -> 0.9.5 — NixOS/nixpkgs0 reactions · 6 comments
- Apr 30, 2026fix(container): update ghcr.io/foxcpp/maddy ( 0.9.3 ➔ 0.9.4 ) — drag0n141/home-ops0 reactions · 2 comments
- Apr 16, 2026Maddy Mail Server: LDAP Filter Injection via Unsanitized Username — NixOS/nixpkgs0 reactions
- Apr 12, 2026fix(container): update image ghcr.io/foxcpp/maddy (0.9.2 → 0.9.3) — drag0n141/home-ops0 reactions · 2 comments
- Mar 30, 2026chore(deps): update ghcr.io/foxcpp/maddy docker tag to v0.9.2 — moritz31/homeops0 reactions
- Mar 28, 2026feat(container): update image ghcr.io/foxcpp/maddy to v0.9.5 — cbrherms/home-ops0 reactions · 2 comments
- Mar 28, 2026feat(container): update image ghcr.io/foxcpp/maddy to v0.9.6 — snazy2000/K8s-at-home0 reactions · 2 comments
- Mar 28, 2026feat(container): update image ghcr.io/foxcpp/maddy ( 0.8.2 → 0.9.5 ) - autoclosed — zednotdead/gensokyo0 reactions · 2 comments
- Mar 27, 2026fix(docker-image): update ghcr.io/foxcpp/maddy docker tag to v0.9.2 — angelnu/helm-charts0 reactions
- Mar 26, 2026fix(container): update image ghcr.io/foxcpp/maddy (0.9.1 → 0.9.2) — drag0n141/home-ops0 reactions · 2 comments
- Mar 26, 2026fix(docker-image): update ghcr.io/foxcpp/maddy docker tag to v0.9.2 — angelnu/k8s-gitops0 reactions
- Mar 26, 2026chore(container): update image ghcr.io/foxcpp/maddy (eb2a738 → 1105627) — drag0n141/home-ops0 reactions · 2 comments
- Mar 25, 2026feat(container): update image ghcr.io/foxcpp/maddy (0.8.2 → 0.9.1) — drag0n141/home-ops0 reactions · 2 comments
- Mar 25, 2026maddy: 0.8.2 -> 0.9.2 — NixOS/nixpkgs0 reactions · 7 comments
- Mar 25, 2026feat(container): update image ghcr.io/foxcpp/maddy (0.8.2 → 0.9.0) — drag0n141/home-ops0 reactions · 3 comments
- Mar 25, 2026feat(container): update image ghcr.io/foxcpp/maddy to v0.9.4 — cftechwiz/homelab-ops0 reactions
- Mar 25, 2026feat(container): update image ghcr.io/foxcpp/maddy ( 0.8.2 → 0.9.5 ) — nickdavies/homelab0 reactions · 1 comment
- Mar 25, 2026feat(container): update ghcr.io/foxcpp/maddy ( 0.8.1 → 0.9.6 ) — JefeDavis/k8s-HomeOps0 reactions
- Mar 25, 2026feat(container): update image ghcr.io/foxcpp/maddy (0.8.2 → 0.9.0) — drag0n141/home-ops0 reactions · 2 comments
- Feb 28, 2026fix(container): update image ghcr.io/foxcpp/maddy ( 0.8.1 → 0.8.2 ) — zednotdead/gensokyo0 reactions · 2 comments
- Jan 17, 2026feat(container): update image ghcr.io/foxcpp/maddy to v0.9.5 — qlonik/musical-parakeet0 reactions · 2 comments
- Jan 17, 2026feat(container): update image ghcr.io/foxcpp/maddy to v0.9.6 — BlauerFasan/dev-home-ops0 reactions · 2 comments
- Jan 14, 2026feat(container): update ghcr.io/foxcpp/maddy ( 0.8.1 → 0.9.4 ) — alexwaibel/home-ops0 reactions · 2 comments
- Jan 14, 2026fix(container): update ghcr.io/foxcpp/maddy ( 0.8.1 → 0.8.2 ) — JefeDavis/k8s-HomeOps0 reactions
- Jan 14, 2026feat(container): update image ghcr.io/foxcpp/maddy ( 0.7.1 → 0.9.3 ) — frantathefranta/home-ops0 reactions · 2 comments
On Hacker News · 4
- Nov 20, 2020Maddy: Composable all-in-one mail server in Go229 points · 113 comments
- May 20, 2020Maddy – Composable all-in-one mail server11 points · 3 comments
- Jun 24, 2022Maddy: All-in-one mail server writen in Go5 points
- Jul 31, 2024Maddy: Composable all-in-one mail server3 points
On Bluesky · 1
- Oct 5, 2025foxcpp/maddy: ✉️ Composable all-in-one mail server. #maddy #email #selfhosted — @latitude77.bsky.social2 likes and reposts
Where files are headingNew AGENTS.md files have more rules about keeping secrets out of the code, and fewer about code style.
Of the AGENTS.md files we read, the 28,693 first seen in the last six months, against the older ones: the kind of rule that gained most share, and the kind that lost most. About files like this in general, not this one, and an estimate, since a kind is a pattern in the words.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

