MailFlag, a lightweight Linux email notification app [AI-Assisted-heavy]

Hi everyone,
I recently released the first public beta of MailFlag, a small free and open-source Linux application that I originally built for myself.
The idea came from a simple annoyance: I didn’t want to keep webmail or a full email client open just to catch verification codes or quickly see incoming mail.
MailFlag runs quietly in the background and monitors your mailbox.
Its main feature is verification-code handling. When an OTP or sign-in code arrives, MailFlag detects it and shows the code prominently in a desktop popup. Clicking the code copies it directly to the clipboard.
So the workflow is basically:
wait for popup → click code → paste
For regular email, the popup also provides quick actions such as:
Open · Delete · Spam · Ignore · Mark as Read
If a popup is missed, MailFlag keeps a small persistent indicator on the desktop so the message isn’t simply forgotten.

Email support

MailFlag currently supports:

  • Yahoo Mail through a built-in preset

  • Custom IMAP / IMAPS accounts
    With Custom IMAP you can manually enter the server, port, SSL/TLS setting, username and password/app password, so it can work with many standard IMAP-compatible providers, hosting accounts and self-hosted mail servers.
    The Custom IMAP implementation has also been successfully tested with a separate email provider.
    Gmail and Outlook configurations that require dedicated OAuth integration are not supported yet.

Other features

  • Multiple email accounts

  • Per-account monitored folders

  • IMAP IDLE for near-real-time notifications

  • Automatic reconnect after network interruptions

  • Recovery after suspend/resume

  • Local message processing

  • Credentials stored in the Linux system keyring

  • No MailFlag cloud

  • No analytics, advertising or telemetry

  • GPLv3 open source
    MailFlag is currently focused on Linux and has been tested primarily on Linux Mint 22.x.
    This is still beta software, so I’d be especially interested in feedback from people willing to try it on other Linux distributions or with different IMAP providers.
    Website:
    https://slavabc.github.io/MailFlag/
    GitHub:
    https://github.com/SlavaBC/MailFlag

I need to ask you to declare the extent to which AI was used in development of this app.

MailFlag is my idea, and I developed it using vibe coding. AI wrote much of the code, while I defined the requirements, features and user experience, tested the app in everyday use on Linux Mint, reported problems and guided fixes and improvements. The source code is publicly available under GPLv3.

Thank you for the honest assessment.
I am satisfied that it was done in a way that will be maintainable, and that there is someone who understands it.

The announcement says credentials are stored in the Linux system keyring. How does MailFlag handle IMAP passwords locally when a keyring isn’t available or is locked? Does it ever fall back to a config file?

It would also be useful to test the background memory footprint over time while monitoring multiple folders over IMAP IDLE connections, including after reconnects.

This sounds like the kinda thing I’d ban…

Some AI slopwritten code wants my creds? Where are you going to store them? How?

Yeh, Nah - you can f–k right off with your slop…

Notified about a new email? Didn’t we already to that in the f–king 1990’s ? :

I can’t recall the exact wording - but - there’s some things you don’t need to share - single use case apps are something that DOES NOT NEED TO BE SHARED!

Yeah, it is marginal. I approved it, but I had reservations.

On my tablet i have it set for my orange mail and for whatsapp, why just because it saves me opening looking for mail. Bit like in america a little flag on your mail box, if that still exists or is it just in the movies

It is still a real thing, but not all mail boxes have them. It usually a little red flag. But not for “you got mail” instead the little red flag is asking the mailman to stop to pick up mail to be delivered, even if you are not receiving mail.

Thanks for the correction.

In our local area the post office have removed all the local post boxes used to send mail and now the only one is just outside to post office itself, some 10 km away. They have already stopped delivering to one part of our island due to a dispute, and only come to our residence every other day.

They wonder why the mail service is failing

Your mailman picks up mail? We dont have that service? Today mail deliveries in our area are twice per week… parcels have to be picked up at the post office.

Yes here in the states, if the red flag is up, the mail man will stop and pick up the mail. The mail boxes with the red flag are mostly in the rural area where the mailman rides in a truck from one mailbox to the next. The mailbox is located by the road instead of at the house.

Also we still get mail delivered 6 days a week unless there is a holiday during the week. And even tho I do not have a flag on my mailbox, if I stand a price of mail up in the mailbox, the mailman will pick up a letter. Most of the time I usually take my mail to the post office which is only 1.5 miles (2.5 km) away.

My mailbox is mounted by my front door, so I get home delivery.

Yes, we have a road mailbox. It is a security nightmare. We get most of our mail addressed to a Post Office Box… so we pick it up when in town.

I’ve always liked the US idea of a mailman flipping up a “thing” to show he’d delivered something…

I seem to remember mailmen in Sydney used to blow a whistle when something was delivered?

Just watched the post girl on her bike in the village next to us

Looked interesting, but when fully loaded and delivering to a hilly village hope its electric and well geared she will have great legs afterwards

No, the flag is a signal that the box has out going mail to be delivered. When he picks up the out going mail he lowers the flag. If the flag is not up and there is no mail to be delivered, he can just pass that mailbox and go to the next one.

The red flag, like a red light, is asking him to stop even if no mail is being delivered to the mailbox. The customer raises the flag when there is mail to be pick up.

Email sort of makes that obsolete … it sends instantly.

That looks very inadequate seating setup.
We use real ‘postie’ bikes … Honda ct110.

You can not pay your bills by email.