// the find
LukeSmithxyz/mutt-wizard
A system for automatically configuring mutt and isync with a simple interface and safe passwords
mutt-wizard is a shell script that automates the painful parts of setting up neomutt with offline IMAP sync (via isync/mbsync) and password management via GPG/pass. It generates all the dotfiles — neomutt, msmtp, mbsync configs — from a single `mw -a you@email.com` command. Aimed at terminal-first Linux users who want email stored locally without spending a weekend reading neomutt docs.
The domains.csv approach is practical: it pre-populates IMAP/SMTP settings for common providers so you don't look them up manually. Password storage via `pass` + GPG is the right call — credentials are encrypted at rest and never written to a plaintext config file. The account-per-file config layout in ~/.config/mutt/accounts/ means you can hand-edit individual accounts without the wizard stomping on your changes. The script being POSIX sh rather than bash is genuine discipline for something that runs across many distros.
The nine-account hard cap is arbitrary and baked into the keybinding generation — it's a code limitation masquerading as a feature. isync's UTF-8 deficiency is acknowledged in the README but there's no workaround, so if your mailbox has non-Latin folder names you'll just get garbled output and silently missing shortcuts. The Ubuntu/Debian caveat about neomutt version mismatches is a real issue that could leave someone with a broken config and no clear path to fix it — the README just says 'install manually'. Push notifications require manually running systemctl for each account with the raw email address embedded in the service name, which is fragile and error-prone.