Jev Mail

AI inbox triage for Gmail: classify, auto-label and safely clean up your inbox.

A Chrome & Brave extension powered by TypeSafe's Jev model, using your own OpenRouter or TypeSafe key. No server. Nothing is ever permanently deleted.

☆  OpenAI       Review needed: safety identifier activity   Security/Alerts  High    !  ↩    S 20%
☆  Amazon.com   Ordered: 4 Electronics items                Orders/Shipping  Low       R 4%  S 45%
☆  Linear       ENG-2214 assigned to you                    Work             Medium     ↩    S 2%

Just want badges in Gmail? Steps 1–3 are all you need. No Google Cloud setup.

1. Get an API key, ideally a dedicated one with a spending limit: OpenRouter or TypeSafe.
2. Load the extension: open chrome://extensions (or brave://extensions), turn on Developer mode, click Load unpacked and pick this folder.
3. Add your key: click the toolbar icon → Settings → paste it → Test → Save. Then open Gmail; rows get badged as you scroll.

Want labels, cleanup and the side panel? Also do Connect Gmail below.

cp .env.example .env

OPENROUTER_API_KEY=sk-or-v1-...
TYPESAFE_API_KEY=            # either key works
# JEV_PROVIDER=typesafe      # prefer TypeSafe when both are set
# JEV_MODEL=jev-1.13         # pin a model version

Labels, cleanup, the side panel and the dashboard use the Gmail API, which needs a free Google OAuth client. This takes about 5 minutes and is only done once.

1. In Google Cloud Console, create a project (e.g. "Jev Mail") and enable the Gmail API.
2. Google Auth Platform → Branding / Audience: choose External, keep it in Testing, and add your Gmail address under Test users.
3. Data access: add the scopes .../auth/gmail.modify and .../auth/gmail.labels.
4. Clients → Create client → Web application. Under Authorized redirect URIs, paste the Redirect URL shown in the extension's Settings → Gmail (it looks like https://<extension-id>.chromiumapp.org/).
5. Copy the Client ID into Settings → Gmail → Google OAuth client ID and save.

That's it: press Classify inbox in the side panel (or Start in the dashboard) and approve access.

The side panel opens from the toolbar icon. The dashboard opens from the panel's Dashboard link and holds all the settings.

Jev/<Category>                 e.g. Jev/Work, Jev/Finance & Invoices
Jev/Priority/High · Medium · Low
Jev/Needs Reply
Jev/Review                     low-confidence results land here, and only here

• Created automatically and applied in batches (batchModify, up to 1,000 per call).
• Below the confidence threshold (default 0.75) an email gets only Jev/Review: no other label, no archiving.
• Archive after labeling (off by default) removes the email from the inbox for the categories you choose. It stays in All Mail.
• Your own labels are never touched. If an email's category changes, its old Jev/ labels are swapped out.

• Preview first. Candidates are listed with sender, subject, reason and confidence. Nothing is pre-selected. View by sender to approve "142 emails from promo@shop.com" with one tick.
• Trash only. Gmail empties Trash after 30 days. Undo brings the last batch back.
• Only confident junk: junk = yes at or above the cleanup threshold (default 0.9).
• Always protected:
  • starred and Gmail-important emails
  • emails marked important, needing a reply, or High priority
  • protected categories (default Finance/Invoices, Security/Alerts)
  • protected senders and domains
  • anything newer than 7 days
  • low-confidence results and genuine service notices
• Re-checked live: labels are re-read from Gmail right before trashing, so an email you starred a minute ago is skipped.
• Logged locally: date, sender, subject and message ID. Never bodies.

Default categories: Work, Personal, Finance/Invoices, Orders/Shipping, Security/Alerts, Newsletters, Promotions, Social, Spam.

• No backend. The extension talks only to Gmail and to your AI provider (openrouter.ai or api.typesafe.ai).
• Sent per email: sender name and address, subject, Gmail tab, and the first ~4,000 characters of the body as plain text. Badges classified straight from the Gmail page send Gmail's preview line instead.
• Stored locally: results in IndexedDB, settings and keys in chrome.storage.local. Email bodies are never stored.
• Cost: billed by your provider at Jev's per-token rate, a few thousand input tokens per email. The dashboard shows a running estimate.

POST https://openrouter.ai/api/v1/systemone      // or https://api.typesafe.ai/v1/systemone
{
  "model": "~typesafe/jev-latest",
  "state": {
    "from_name": "Google Cloud",
    "from_address": "CloudPlatform-noreply@google.com",
    "subject": "[Action Required] Your billing account has been suspended",
    "body": "We were unable to process your payment…",
    "gmail_tab": "Updates"
  },
  "questions": {
    "category":    { "type": "choice", "instructions": "Which single category…", "criteria": { "Work": "…", "Finance/Invoices": "…" } },
    "priority":    { "type": "choice", "instructions": "How soon does the recipient need to act…", "criteria": { "Low": {}, "Medium": {}, "High": {} } },
    "important":   { "type": "noul", "instructions": "Is this email important to the recipient personally…" },
    "junk":        { "type": "noul", "instructions": "Is this email safe to clean up…" },
    "needs_reply": { "type": "noul", "instructions": "Does the recipient need to reply…" }
    // + deceptive, unsolicited, official_domain, service_notice
  }
}

manifest.json
src/
├── background/service-worker.js   side panel, Gmail overlay messaging
├── common/
│   ├── auth.js                    Gmail OAuth (launchWebAuthFlow)
│   ├── gmail.js                   Gmail API: read, labels, batchModify, trash/untrash
│   ├── jev.js                     questions, scoring rules, Jev client
│   ├── labels.js                  Jev/... labels: create, plan, apply
│   ├── cleanup.js                 protections, candidates, trash, undo, log
│   ├── cleanup-preview.js         confirm-before-trash checklist
│   ├── pipeline.js                fetch → classify → store
│   ├── settings.js                defaults, .env, provider selection
│   └── db.js · key.js · run-lock.js
├── content/                       badges inside Gmail
├── dashboard/                     table view and settings
└── panel/                         side panel

MIT. Based on jev-mail by ilyasy.

_{Gmail AI extension · AI email organizer · Gmail auto label · Gmail cleaner · bulk delete Gmail by sender · inbox zero · email triage · spam filter · OpenRouter · TypeSafe Jev}