User repository on GitHub
Autonomous 24/7 Zero-Inbox triage for Gmail powered by TypeSafe Jev System One
- Forks
- 2
- Last pushed
- Updated Sep 2026
Repo stats from the GitHub API, cached Oct 2026.Homepage
CommunityJev Integrations & Adapters
Jev-Mail
CLI-installed Gmail classifier that runs 24/7 on user-owned Google Apps Script: the worker asks Jev for three typed judgments per thread (requires_action, is_important, bucket), applies labels, stars, and optional archiving, and routes ambiguous or low-confidence mail to a Review label.
- Stars
- 12
- Language
- TypeScript
- License
- MIT
- Published by
- Community
- Last verified
- Oct 2026
About this project
Jev-Mail is a small Gmail inbox classifier with a CLI for installation, configuration, preview, and operations. The CLI uploads a versioned Google Apps Script worker. The worker polls the Gmail inbox on a Google time trigger, asks Jev for typed judgments, and applies labels, stars, and archive decisions even when the user's computer is off.
Quoted from the project's README. Read the full README.
- Languages
- TypeScript
- Capabilities
- Open sourceSelf-hostedRequires API key
Highlights
- A versioned Google Apps Script worker polls on a Google time trigger, so the user's computer does not need to stay on; the CLI is not a daemon.
- Each thread gets three typed judgments: requires_action, is_important, and bucket, validated by probability thresholds before any Gmail change.
- Preview classifies up to 20 inbox threads without changing Gmail; label-only is the default onboarding mode and archiving is opt-in.
- Exit codes are stable for automation: 0 success, 1 failure, 2 invalid usage, 3 authorization needed, and 4 remote execution failure.
- Thresholds are configurable in YAML; ambiguous action probabilities or low category confidence stay in the inbox with the Review label.
Watch out
MIT license; it requires a TypeSafe API key plus a Google Cloud project with a Desktop OAuth client, and during External Testing Google expires test-user authorization and refresh tokens after seven days.
Questions about this entry
Short answers drawn from the linked project or page.
No. The CLI uploads a versioned Google Apps Script worker that polls the Gmail inbox on a Google time trigger and applies decisions even when the user's computer is off; the CLI is only used for install, preview, and operations.
The worker validates returned probabilities before mutating Gmail. An ambiguous action probability, low category confidence, unknown category, changed thread, or partial archive condition leaves the message in the inbox with a Review label.
The sender, recipient, subject, a bounded body snippet, and limited previous context when it is needed. The worker then asks for three typed judgments: requires_action, whether the recipient needs to reply, decide, approve or perform a task; is_important, whether an action item deserves a star; and bucket, which configured category best describes a non-action message.
Exit codes are stable for automation: 0 success, 1 unexpected failure, 2 invalid usage or configuration, 3 authorization or Google setup needed, 4 remote execution failure. Commands cover init, preview --limit N for up to 20 threads without touching Gmail, enable, disable, status, update, and a config family with init, show, validate, migrate, edit, apply and set-mode.
Node.js 22+, a TypeSafe key, a Gmail account, and a Google Cloud project that owns a Desktop OAuth client with the Apps Script API and Gmail API enabled. A restricted organization consent screen blocks personal Gmail accounts, and in External testing Google expires test-user authorization and the offline refresh token after seven days, so you reauthorize with init --reauthorize.
It is a Google platform limit rather than a choice: the Apps Script execution API does not create installable time triggers for this workflow, so you pick installTrigger in the function selector and run it once. The trigger is created paused and classifies nothing until enable is run, which is why the onboarding order is init, link, installTrigger, init again, preview, enable.
The key is sent over the authenticated Google execution API into the worker's Script Properties; it is never written to the repository or printed by the CLI, and TYPESAFE_API_KEY in the environment is preferred over a command-line argument. Local CLI state lives under ~/.config/jev-mail by default, and --home DIR gives you a separate installation.
Reactions & coverage
Posts, threads, and videos about this entry from around the web.
Instagram: A claim triage tool that routes suspicious claims and never denies one.
X: Intent-based search in Gmail
X: 400 companies matched to one candidate
X: Watching 25 customer groups on WhatsApp
More Jev resources like this
12.4kGitHub stars
Open-source AI email assistant (Next.js, Postgres, 12k+ stars) with a decision-model layer that can run on openrouter:typesafe/jev-1.13: Jev-backed questions cover rule selection, cold-email detection, thread status, recurring patterns, unsubscribe pages, and sender categorization, each with evals.
Jev Integrations & Adapters#community#email#gmail
Community
elie222/inbox-zeroTypeScript
elie222/inbox-zeroTypeScript33kGitHub stars
Alibaba's multi-agent platform, which implements native TypeSafe Jev classification through JevClassifierModel for binary, choice and score routing across agent pipelines. Python 3.11+, Apache-2.0, with a FastAPI agent service and web UI.
Jev Integrations & Adapters#community#multi-agent#framework
Community
agentscope-ai/agentscopePython
agentscope-ai/agentscopePython88.2kGitHub stars
Real-time geopolitical intelligence dashboard that uses TypeSafe Jev questions to score news headline severity into five threat levels and categorize events across 14 conflict, cyber and infrastructure domains, alongside news aggregation and a Country Instability Index.
Jev Integrations & Adapters#community#osint#geopolitics
Community
koala73/worldmonitorTypeScript
koala73/worldmonitorTypeScript19.6kGitHub stars
Open-source TypeScript agentic operating system: a core runtime, app for web and mobile, CLI, cloud services and first-party plugins. The directory's curated summary reports it integrates TypeSafe System One decision services for sub-100ms intent classification, action dispatching and confidence-gated tool execution.
Jev Integrations & Adapters#community#agents#framework
Community
elizaOS/elizaTypeScript
elizaOS/elizaTypeScript689GitHub stars
The Vercel AI SDK provider for OpenRouter, including openrouter.decisionModel for typesafe/jev-1.13 evaluations with providerMetadata answers.
Jev Integrations & Adapters#community#typescript#openrouter
2GitHub stars
A shell-first CLI for yes or no, multiple-choice, and leveled decisions through TypeSafe Jev, composable with files and JSON context in scripts.
Jev Integrations & Adapters#community#cli#shell
Community
vsekhar/decideSwift
vsekhar/decideSwiftFrom the Jev community
Posts from builders shipping with Jev right now.