mailroom
Gmail organiser where readable rules do most filing and Jev judges only what rules leave, with receipts and undo for every change.
Overview
Mailroom keeps a Gmail mailbox sorted. Deterministic rules do most of the work for free: labelling on arrival, archiving stragglers, trashing expired codes and stale notifications, and marking old promotions read. Primary-tab mail the rules cannot place goes to Jev, which answers five narrow typed questions per email, once per message and cached. Every run previews first, writes a receipt row for each change, and can be undone; nothing is ever sent, unsubscribed or permanently deleted.
Other features include plain-word search, where code finds senders, dates and status words and Jev picks category, window and intent to produce an editable Gmail query; sender-by-sender decisions over 90 days of mail crossed with how often you open it, turned into standing rules; routes that become Gmail filters, including adopting existing filters; and grading a receipt by asking Jev whether each trashed or filed email was handled right, with one-click reversal of disagreements. It uses thirteen fixed labels so search always works. A live personal deployment exists with bring-your-own-key Jev, capped at 100 users; the README recommends self-hosting.
What the decision model decides
| Type | Question | Answers |
|---|---|---|
| Choice | Which of the thirteen labels fits this email?(inferred) | Work · Personal · Banking & Finance · Receipts · Trips & Travel · Events · Recruiting · School · Dev Notifications · Social Media · Newsletters · Marketing & Deals · Accounts & Security |
| Yes / no | Was this email handled correctly (trashed or filed)? | — |
| Choice | What category, time window and intent does this plain-word search mean? | — |
How it works
- Rules label, archive and clean up mail
- Remaining Primary-tab mail goes to Jev with typed questions
- Proposed changes are previewed, then applied with receipts
- Sender decisions become standing rules and Gmail filters
- Receipts can be graded by Jev and reversed
Strengths
- Rules first, model only where needed
- Receipts and undo for everything
- Never permanently deletes or sends
- Low cost per message
Caveats
- Hosted version capped and shows an unverified-app warning
- Fixed label set
- Self-hosting takes about an hour
Getting started
Use mailroom.kevinliu.studio with your own Jev key, or clone and follow the setup to self-host.At a glance
- Type
- Demo
- Status
- beta
- Language
- TypeScript
- Runtime
- web app with Gmail API
- Has code
- yes
Use cases and integrations
How curated lists describe it
Your Gmail, sorted. Rules you can read, typed AI judgments from TypeSafe's Jev for pennies, receipts and undo for everything.
hellogumbo/awesome-jev
Frequently asked questions
Does Jev see all my mail?
Only Primary-tab mail the rules could not place, once per message.
Can I undo changes?
Yes, every run writes a receipt and can be undone.
Can I use custom labels?
No, it uses thirteen fixed labels so search always works.
Related projects
Config-driven IMAP inbox classifier with a terminal UI where Jev answers yes/no per category to tag, move, flag or notify.
ProjectbetaPythonMac app with AI bots running business ops on cloud computers, using TypeSafe for small yes/no calls like risk and which bot takes a job.
ProjectproductionLocal open-source work assistant that turns mail and tickets into agent tasks, with an optional Jev condition-check module.
ProjectbetaPythonOpen-source AI email assistant; listed as using Jev as an optional classifier for email intent and triage.
ProjectproductionTypeScriptGlue that turns one Linux machine into a team of coding agents, with Jev making typed calls like who builds a task and whether it may merge.
ProjectbetaTypeScriptAgent harness for long-running jobs that survive across sessions; listed for a Jev-backed table that routes requests to models.
ProjectbetaTypeScript