Email (IMAP and SMTP)

Reads and sends mail of any provider

You make: your mail password, or an app password if your provider has them
Command: kokuban connect email --account <you@example.com> --base imaps://<imap.example.com> --host <smtp.example.com>

Steps

Find your provider's IMAP and SMTP server names (its help pages say)IMAP is usually on port 993 (imaps://), SMTP on 465 or 587.
If it has app passwords, make one named kokuban

Then connect it

kokuban connect email --account <you@example.com> --base imaps://<imap.example.com> --host <smtp.example.com>

kokuban asks for the key (it is not shown as you paste it), keeps it in your OS keychain, and tries it at once. If the key cannot do something, it says what to change.

On kokuban's screen, the connections list shows the services not connected yet: open one and press y, and the screen hands the terminal to this command.

Good to know

--base is the IMAP server, --host the SMTP server. kokuban connects out to both; nothing listens for mail on your computer.

If it does not work

Turn on IMAP in your mail's settings

kokuban connections checks every connection and says which ones need you.

Taking it back

Run kokuban disconnect email@hq, then delete the app password (or change the password) at your provider.