FAQ

Questions that came up when people using neomd.

Is it possible to create new directories/tabs

Currently, no. All folders are hard coded in a struct in a code as this is optimized for the GTD and HEY Screener workflow and keeps things simple.

But, please reach out to me and tell me which folders you need, maybe it’s a folder that everyone might use, or otherwise, if I get enough request, I add a way to customize folders as I do with the sort order of folder tabs already.

Advanced: Add custom folders yourself

You can fork neomd and modify the Go source code:

1. Edit the code (ask Claude to help with this):
   • Add a field to FoldersConfig struct in internal/config/config.go
   • Add entry to keyToLabel map
   • Optionally add keyboard shortcuts in internal/ui/model.go

• Run make build to compile

2. Create the IMAP folder via webmail (e.g., “NewFolder”)
3. Configure it in your config.toml:

[folders]
  # ... existing folders ...
  new = "NewFolder"
  tab_order = ["inbox", "to_screen", "feed", "new", "sent", "archive"]

Once added this way, you can navigate to your custom folder with existing []HL and space+1-9. If you added keyboard shortcuts in step 1, those will work too (e.g., gn / Mn).

Does the signature appear only in new messages, not in replies?

Currently the signature is only automatically added if you create and compose a new email.

But you can add the signature in any email, e.g. if you reply with [html-signature] like this:

# [neomd: to: email@domain.com]
# [neomd: from: Simon <my-email@ssp.sh>]
# [neomd: subject: Re: Subject Title]


Here's my reply.
BR Simon

[html-signature]

---

> **Previous sender <email@domain.com>** wrote:
>
> * * *
......

The html-signature is the placeholder for adding the HTML signature, but yes, it will always be added at the end of the email (e.g. in this case the reply).

The Drafts and Spam folders seem to show wrong emails

Drafts and Spam are off-tab folders (not in the regular tab rotation) and behave slightly differently:

• Access: gd for Drafts, gS for Spam (or :go-spam)
• Indication: When viewing them, the folder name appears highlighted in the tab bar with a │ separator
• Reload: Pressing R reloads the Drafts/Spam folder
• Leave: Press tab or navigate to another folder (gi, ga, etc.) to return to regular tabs

Old bug (fixed 2026-04-10): In older versions, pressing R while viewing Drafts could show Inbox content. If you experience this, rebuild neomd to get the fix.