omarchy-mail
Terminal Gmail client for Omarchy where Jev files mail into Gmail labels when confident and grades replies as you write.
Overview
Mail for Omarchy is a lightweight terminal Gmail client for the Omarchy Linux setup, with arrow-key and Ctrl shortcuts and categories that are real Gmail labels so they sync to your phone. TypeSafe's Jev does two jobs. It sorts the inbox: every new message is filed into the category it fits, but only when Jev is above a configured threshold; personal or unclear mail stays in the Inbox, and Ctrl+J shows how Jev weighed each category.
It also reads replies as you write them: a sidebar grades clarity, tone, length, next step and language as green, yellow or red bars, and checks which questions and requests in the original message are still unanswered. Categories are defined with descriptions in a TOML file, and a systemd timer can auto-sort new mail every five minutes. It needs a Gmail app password and a TypeSafe key.
What the decision model decides
| Type | Question | Answers |
|---|---|---|
| Choice | Which category (Gmail label) does this message belong to? | — |
| Score | How clear / well-toned / appropriately long is this reply? | red · yellow · green |
| Yes / no | Has this question from the original message been answered? | yes · no |
How it works
- New mail arrives (timer runs every five minutes).
- Jev scores each category described in categories.toml.
- File into a label only above the threshold; otherwise leave in Inbox.
- While replying, show grades and unanswered questions in a sidebar.
Strengths
- Conservative: unclear mail stays in the Inbox.
- Labels sync to Gmail on all devices.
- Transparent per-category weights via Ctrl+J.
Caveats
- Omarchy-specific; requires a TypeSafe key and Gmail app password.
- Message content is sent to TypeSafe.
Getting started
omarchy plugin add https://github.com/petrzpav/omarchy-mail --enable, run its install.sh, fill in ~/.config/petrzpav-mail/, then systemctl --user enable --now mail-sort.timer.At a glance
- Type
- Library
- Status
- beta
- Language
- Python
- Runtime
- terminal app, Omarchy plugin
- Has code
- yes
Use cases and integrations
How curated lists describe it
Terminal Gmail client for Omarchy. Jev (TypeSafe AI) files your inbox into Gmail labels and checks your replies as you write.
hellogumbo/awesome-jev
Frequently asked questions
What does Jev decide?
Which label a message belongs in, and how a draft reply scores on clarity, tone, length, next step and language.
What if Jev is unsure?
The message stays in the Inbox.
Do I need Omarchy?
Yes, it installs as an Omarchy plugin.
Related projects
Open-source AI email assistant; listed as using Jev as an optional classifier for email intent and triage.
ProjectproductionTypeScriptConfig-driven IMAP inbox classifier with a terminal UI where Jev answers yes/no per category to tag, move, flag or notify.
ProjectbetaPythonTriage for DingTalk mail and chats where Jev sorts messages into needs-reply, updates, promo, sales or spam with attention flags.
ProjectbetaPythonGoogle Apps Script that labels, archives or trashes Gmail conversations based on Jev answers to your plain-English yes/no questions.
ProjectbetaJavaScriptGmail classifier running on Google Apps Script where Jev decides action-needed, importance and category for each thread.
ProjectbetaTypeScriptChrome/Brave extension that uses Jev to classify, label and safely bulk-clean a Gmail inbox with undo.
PluginbetaJavaScript