A minimal email TUI where you read with Markdown and write in Neovim.
neomd.ssp.sh/docs
email
markdown
neovim
tui
update
+7
-10
+7
-10
README.md
+7
-10
README.md
···
146
146
147
147
1. From your Inbox, pick an email and press `I` (screen **in**) to approve the sender, or `O` (screen **out**) to block them. This creates your first screener list entry.
148
148
2. Once you've classified at least one sender, auto-screening activates on every Inbox load — new emails from known senders are sorted automatically.
149
-
3. Unknown senders land in the `ToScreen` tab. Jump there with `gk` (or `Tab`, or click the tab) and classify them:
149
+
3. Unknown senders land in the `ToScreen` tab. Jump there with `gk` (or `Tab`, use `L` or click the tab) and classify them:
150
150
- `I` screen **in** — sender stays in Inbox forever
151
151
- `O` screen **out** — sender never reaches Inbox again
152
152
- `F` **feed** — newsletters go to the Feed tab
···
158
158
You choose who can land in your Inbox. Bye-bye spam. This is the beauty of [HEY-Screener](https://www.hey.com/features/the-screener/), and neomd implements the same concept.
159
159
160
160
> **Tip:** To disable auto-screening entirely, set `auto_screen_on_load = false` in `[ui]` config. Run `:debug` inside neomd if something isn't working.
161
-
## Keybindings
161
+
### Screener Workflow
162
+
163
+
Find full Screener Workflow at [docs/screener.md](docs/screener.md), classification tables, and bulk re-classification instructions.
164
+
### Keybindings
162
165
163
166
Press `?` inside neomd to open the interactive help overlay. Start typing to filter shortcuts.
164
167
165
168
See the [full keybindings reference](docs/keybindings.md) (auto-generated from [`internal/ui/keys.go`](internal/ui/keys.go) via `make docs`).
166
169
167
-
## Screener Workflow
168
-
169
-
Unknown senders land in `ToScreen`; press `I/O/F/P` to approve, block, or classify them. Auto-screening keeps your inbox clean without manual intervention.
170
-
171
-
See [docs/screener.md](docs/screener.md) for the full workflow, classification tables, and bulk re-classification instructions.
172
-
173
-
## How Sending Works
170
+
### How Sending Works
174
171
175
172
Compose in Markdown, send as `multipart/alternative` (plain text + HTML). Attachments, CC/BCC, multiple From addresses, drafts, and pre-send review are all supported.
176
173
177
174
- See [docs/sending.md](docs/sending.md) for details on MIME structure, attachments, pre-send review, and drafts.
178
175
- See [docs/reading.md](docs/reading.md) for the reader: images, inline links, attachments, and navigation.
179
176
180
-
## Make Targets
177
+
### Dev: Makefile Commands
181
178
182
179
```
183
180
make build compile ./neomd