User repository on GitHub
Terminal Gmail client for Omarchy. Jev (TypeSafe AI) files your inbox into Gmail labels and checks your replies as you write
- Forks
- 0
- Last pushed
- Updated Oct 2026
Repo stats from the GitHub API, cached Oct 2026.
CommunityJev Repos & SDKs
Omarchy Mail
Terminal Gmail client for Omarchy where categories are Gmail labels, Jev files confident matches automatically, and a sidebar grades reply clarity, tone, length, next steps, and coverage.
- Stars
- 3
- Language
- Python
- License
- MIT
- Published by
- Community
- Author
- petrzpav
- Last verified
- Oct 2026
About this project
A light terminal Gmail client for Omarchy. Arrow keys and Ctrl shortcuts (no vim), categories that are Gmail labels (so they show up on your phone too), and Jev (TypeSafe AI), which files your mail into them and reads your replies before you send them. Sorts your inbox. Every new message goes into the category it fits, as a Gmail label. Jev only acts when it's confident (threshold). Anything personal or unclear stays in the Inbox. Ctrl+J on any message shows how Jev weighed every category, and Enter moves it there.
Quoted from the project's README. Read the full README.
Highlights
- Sorts new mail into Gmail-label categories at a confidence threshold and keeps personal or unclear mail in the Inbox.
- Shows per-category weights on demand and grades replies on clarity, tone, length, next step, language, and unanswered questions.
- Installs as an Omarchy plugin with mail commands, mailto handling, config copies, and an optional five-minute user timer.
- Supports scripting, JSON output, Claude Code skills, local plus Gmail Drafts, and address-aware From handling over SMTP.
Watch out
Gmail access uses an app password with 2-Step Verification, Jev receives message content for sorting and review, and mail itself stays in Gmail. Copy reviewed against the repository README on 2026-10-04, not from running it.
Questions about this entry
Short answers drawn from the linked project or page.
Only at or above the configured threshold. Personal or unclear mail stays in the Inbox, Ctrl+J shows how every category weighed, Enter moves it, every decision logs to sort.log, and Jev history can restore a message.
The client sends sender, recipient, subject, and the start of the body for sorting, plus the draft and original message for a review. Without a key the rest of the client still works.
Add the Omarchy plugin, run install.sh to install commands and timer links, fill in addresses, categories, and secrets, then enable the user timer for sorting about every five minutes.
Run the bundled demo on a made-up inbox with only a TypeSafe key, or use dry-run sort, backfill that only adds labels, JSON list output, shell search and draft commands, and Gmail Draft sync.
Omarchy with shell plugins and uv (sudo pacman -S uv); uv installs Python 3.12 or newer plus Textual, httpx, and html2text into a venv on first run. Gmail signs in with an app password, which needs 2-Step Verification enabled on the Google account.
systemctl --user enable --now mail-sort.timer lets Jev sort new mail every five minutes, moving a message only at or above the configured threshold confidence. Every decision is logged to ~/.local/state/petrzpav-mail/sort.log, and Jev history in the palette puts a message back.
Yes. The default rubric grades clarity, tone, length, next step, and language, but you can replace it with [[review]] entries in config.toml, each with a name, question, good, ok, and poor value, plus reply_only to apply it only to replies.
More Jev resources like this
3GitHub stars
Python policy engine that defines Noul, Choice, and Score rules in YAML with tags, audit mode, and fail-closed handling, usable from a CLI or backend code.
Jev Repos & SDKs#community#github
Community
BhavinM/jev-policy-enginePython
BhavinM/jev-policy-enginePython34GitHub stars
Drop-in Jev client wrapper that averages Choice predictions across option orderings in one request for stabler probabilities.
Jev Repos & SDKs#community#jevbest#catalog-import
Community
TypeLLM/pijevPython
TypeLLM/pijevPython21GitHub stars
Self-hosted Python SDK and System One-compatible API for runtime-defined Choice, Boolean and Score decisions on pinned open models, across Torch, vLLM, MLX, llama.cpp and WebGPU. Each result records probabilities, token usage, timing, model revision and prompt version, with committed row-level benchmarks.
Jev Repos & SDKs#community#sdk#self-hosted
Community
chengyongru/fastjevPython
chengyongru/fastjevPython13GitHub stars
Go Unix CLI that pipes state on stdin into one Jev question — noul, choice, or score — across TypeSafe, Cloudflare, and Vercel providers, printing machine-readable JSON and signaling success by exit code.
Jev Repos & SDKs#community#github
Community
stefafafan/jevGo
stefafafan/jevGo11GitHub stars
A Python decorator that turns a Pydantic model into Jev questions: bool becomes a Noul, a Literal becomes a Choice, and a bounded int becomes a Score, with answers validated back into the model.
Jev Repos & SDKs#community#python#pydantic
Community
aaazzam/jevPython
aaazzam/jevPython7GitHub stars
Unofficial Go and Rust clients for the System One API covering noul, choice and score questions, with env-based config, retries, typed errors and gateway support.
Jev Repos & SDKs#community#github
Community
haileyok/typesafe-clientRust
haileyok/typesafe-clientRustFrom the Jev guides
Original write-ups on what this entry is for.
Closed weights have not stopped the ecosystem from rebuilding the shape in the open. API-compatible servers, retrained heads on small models, and inference-time tricks that skip generation entirely.
Jev Repos & SDKs#open-models#research#local
Read article
From the Jev community
Posts from builders shipping with Jev right now.