A minimal email TUI where you read with Markdown and write in Neovim.
neomd.ssp.sh/docs
email
markdown
neovim
tui
1---
2title: neomd
3layout: hextra-home
4toc: false
5---
6
7<div class="hx-mt-6 hx-mb-6">
8{{< hextra/hero-headline >}}
9 A minimal terminal email client <br class="sm:hx-block hx-hidden" />for people who read & write in Markdown
10{{< /hextra/hero-headline >}}
11</div>
12<br>
13<div class="hx-mb-12">
14{{< hextra/hero-subtitle >}}
15 Compose in Neovim, navigate with Vim motions, screen emails like HEY, <br class="sm:hx-block hx-hidden" />process your inbox with GTD — all from the terminal
16{{< /hextra/hero-subtitle >}}
17</div>
18<br>
19<div class="hx-mb-6">
20{{< hextra/hero-button text="Overview and Philosophy" link="docs" >}}
21</div>
22<br>
23<div class="hx-mt-6"></div>
24<br>
25
26<div class="hx-mt-12 hx-mb-8">
27<h2 class="hx-text-4xl hx-font-bold hx-tracking-tight hx-text-gray-900 dark:hx-text-gray-50">What Makes neomd Different?</h2>
28</div>
29<br>
30{{< hextra/feature-grid >}}
31 {{< hextra/feature-card
32 title="HEY-Style Screener"
33 subtitle="Unknown senders wait in ToScreen until you approve (I), block (O), or categorize them. You choose who reaches your inbox — bye-bye spam."
34 class="aspect-auto md:aspect-[1.1/1] max-md:min-h-[340px]"
35 style="background: radial-gradient(ellipse at 50% 80%,rgba(1,97,254,0.15),hsla(0,0%,100%,0));"
36 >}}
37 {{< hextra/feature-card
38 title="GTD Workflow"
39 subtitle="Process your inbox only once. Move emails to Waiting, Someday, Scheduled, or Archive with single keystrokes. Includes Feed and PaperTrail for newsletters and receipts."
40 class="aspect-auto md:aspect-[1.1/1] max-lg:min-h-[340px]"
41 style="background: radial-gradient(ellipse at 50% 80%,rgba(194,97,254,0.15),hsla(0,0%,100%,0));"
42 >}}
43 {{< hextra/feature-card
44 title="Superhuman Speed"
45 subtitle="Folder switches in ~33ms (on fast IMAP providers like Hostpoint). Every action is instant — no loading spinners, no delays. Navigate with Vim motions."
46 class="aspect-auto md:aspect-[1.1/1] max-md:min-h-[340px]"
47 style="background: radial-gradient(ellipse at 50% 80%,rgba(142,53,74,0.15),hsla(0,0%,100%,0));"
48 >}}
49 {{< hextra/feature-card
50 title="Neovim Integration"
51 subtitle="Compose in $EDITOR (nvim), send as Markdown → HTML multipart. Pre-send review prevents accidental sends. Auto-backup drafts to ~/.cache."
52 class="aspect-auto md:aspect-[1.1/1] max-md:min-h-[340px]"
53 style="background: radial-gradient(ellipse at 50% 80%,rgba(12,53,74,0.15),hsla(0,0%,100%,0));"
54 >}}
55 {{< hextra/feature-card
56 title="Direct IMAP/SMTP"
57 subtitle="No local sync daemon. Uses RFC 6851 MOVE for instant operations. Works on any device with your mailbox always in sync."
58 class="aspect-auto md:aspect-[1.1/1] max-lg:min-h-[340px]"
59 style="background: radial-gradient(ellipse at 50% 80%,rgba(221,210,59,0.15),hsla(0,0%,100%,0));"
60 >}}
61 {{< hextra/feature-card
62 title="Keyboard-First"
63 subtitle="Vim motions everywhere. j/k navigation, gg/G jumps, / search, numbered links [1]-[0], multi-select with m, undo with u."
64 class="aspect-auto md:aspect-[1.1/1] max-md:min-h-[340px]"
65 style="background: radial-gradient(ellipse at 50% 80%,rgba(59,130,246,0.15),hsla(0,0%,100%,0));"
66 >}}
67{{< /hextra/feature-grid >}}
68
69<br>
70
71
72*Reading newsletter directly in your email client (feed) - see spy pixel, if you have replied (dot) and thread mode if replied)*
73
74<br>
75
76<div class="hx-mt-12 hx-mb-8">
77<h2 class="hx-text-4xl hx-font-bold hx-tracking-tight hx-text-gray-900 dark:hx-text-gray-50">Video Demo - YouTube rundown of most features:</h2>
78</div>
79
80
81[](https://youtu.be/8aKkldYLWV8)
82
83
84<br>
85<div class="hx-mt-12 hx-mb-8">
86<h2 class="hx-text-4xl hx-font-bold hx-tracking-tight hx-text-gray-900 dark:hx-text-gray-50">Documentation:</h2>
87</div>
88
89{{< cards cols="3" >}}
90 {{< card link="docs" title="Overview & Philosophy" subtitle="Full feature list, installation (binary, AUR, source), philosophy, benchmarks, and inspiration" >}}
91 {{< card link="docs/configuration" title="Configuration Reference" subtitle="Full config with multiple accounts, OAuth2, signatures, and UI options" >}}
92 {{< card link="docs/keybindings" title="Keybindings" subtitle="Complete keyboard shortcuts reference (auto-generated from source)" >}}
93 {{< card link="docs/screener" title="Screener Workflow" subtitle="How to classify emails, bulk operations, and screener lists" >}}
94 {{< card link="docs/reading" title="Reading Emails" subtitle="Navigation, images, links, attachments, threading" >}}
95 {{< card link="docs/sending" title="Sending Emails" subtitle="Compose, attachments, CC/BCC, drafts, HTML signatures" >}}
96 {{< card link="docs/integrations/" title="Integrations" subtitle="Integrations with Newsletter such as Listmonk" >}}
97 {{< card link="docs/faq" title="FAQ" subtitle="Frequently asked questions" >}}
98{{< /cards >}}
99
100<br>
101
102<div class="hx-mb-6">
103{{< hextra/hero-button text="Getting Started: Install" link="docs#install" >}}
104</div>
105
106<br>
107
108<div class="hx-mt-12 hx-mb-8">
109<h2 class="hx-text-4xl hx-font-bold hx-tracking-tight hx-text-gray-900 dark:hx-text-gray-50">Links:</h2>
110</div>
111
112- [GitHub Repository](https://github.com/ssp-data/neomd)
113- [Changelog](https://github.com/ssp-data/neomd/blob/main/CHANGELOG.md)
114- [Roadmap](https://www.ssp.sh/brain/neomd#roadmap)
115- [Security Policy](https://github.com/ssp-data/neomd/blob/main/SECURITY.md)