Jev reads the open chat, judges what the other person wants, and suggests three replies. You choose one. Jev fills the box. You press send.
- It judges before it writes. The judge is TypeSafe's Jev model (
typesafe/jev-1.13). It reads the other person's mood, intent, and risk, then ranks three replies written by a second model. The app is named after that judge. - It knows who is who. Messages on the right are yours. Messages on the left are theirs.
- It never sends. Fill puts a reply in the message box, or copies it. You press Send yourself.
- It uses one OpenRouter key. Jev Assistant has no server. OpenRouter hosts the Jev model, so the same key pays for the judge and the reply drafts. The call happens only when you analyze a chat.
About fourteen seconds on a Mac. He tries a parking-ticket line and she is not impressed. He picks Analyze now from the Jev menu, reads her three moods, and fills the safer reply. She softens, he analyzes again, and Jev finds a warmer mood and a real plan. He presses send himself.
There are two ways to use Jev on a Mac. Both need an OpenRouter key. If you don't have one, create it at openrouter.ai/keys with Create Key. It starts with sk-or-v1-. Set a credit limit there so it can't overspend. That key is the only one to create: OpenRouter hosts TypeSafe's Jev judge (typesafe/jev-1.13), so it covers the judge and the reply drafts.
| Way | Reads | Fills the message box | Needs Chrome Developer mode |
|---|---|---|---|
| Menu-bar app | Apple Messages, WhatsApp Desktop, and any chat in Chrome or Firefox | Yes | No |
| Chrome extension | Instagram, WhatsApp Web, Snapchat Web, and Google Messages in Chrome | Yes | Yes |
Requirements: macOS 14 or newer. For SMS threads, turn on Text Message Forwarding on your iPhone.
1. Build and open the app.
bash mac/package.shOpen mac/build/Jev Assistant.app. A Jev item appears in the menu bar.
Build with bash mac/package.sh, then open mac/build/Jev Assistant.app
2. Allow it to read the screen. Open System Settings → Privacy & Security and turn on Jev Assistant under both:
- Accessibility, for Messages and WhatsApp Desktop.
- Screen Recording, for chats in Chrome or Firefox.
Each rebuild resets these. If Jev stops reading after a rebuild, turn it off and on again in both lists.
3. Save your OpenRouter key. Menu bar Jev → Set Judge API key… → paste → Save. Leave Set Reply API key empty. It reuses the same key.
Jev → Set Judge API key… (fictional key shown)
4. Optional: say who they are to you. Jev → Set relationship…, for example "A classmate I'm trying to ask out."
Jev → Set relationship… (fictional text only)
5. Analyze a chat. Open a chat, leave it in front, and choose Jev → Analyze now. The panel shows the risk, three moods, and three ranked replies. Fill puts a reply in the message box.
The Mac panel (fictional chat)
Use this if you only chat in Chrome and don't want to build the app. It reads Instagram, WhatsApp Web, Snapchat Web, and Google Messages. It can't read Apple Messages or WhatsApp Desktop.
- Unzip it. Double-click the zip in Downloads. You get a folder named
jev-assistant-extension. - Load it in Chrome. Go to
chrome://extensions, turn on Developer mode, click Load unpacked, and select that folder. - Open Jev. Click the puzzle piece in Chrome's toolbar, pin Jev Assistant, then click the Jev icon. The side panel opens.
- Set it up in the panel. Paste your OpenRouter key at the top and click Save. Fill in Who are they to you? It saves as you type.
- Analyze a chat. Open a chat and click Analyze this chat. Fill puts a reply in the message box.
On Windows, use the Chrome extension. It reads Instagram, WhatsApp Web, Snapchat Web, and Google Messages, and Fill puts the reply in the message box. It also works on Linux. If you can't use it, see the alternatives below.
You need an OpenRouter key. If you don't have one, create it at openrouter.ai/keys with Create Key. It starts with sk-or-v1-. Set a credit limit there so it can't overspend. That key is the only one to create: OpenRouter hosts TypeSafe's Jev judge (typesafe/jev-1.13), so it covers the judge and the reply drafts.
Click the button and the zip downloads. Jev is not in the Chrome Web Store yet, so Chrome loads it with Developer mode on.
-
Unzip it. Right-click the zip → Extract All. You get a folder named
jev-assistant-extensionwithmanifest.jsondirectly inside. -
Load it in Chrome. Go to
chrome://extensions, turn on Developer mode in the top right, click Load unpacked, and select thejev-assistant-extensionfolder.
Developer mode → Load unpacked → select thejev-assistant-extensionfolder -
Open Jev. Click the puzzle piece in Chrome's toolbar, pin Jev Assistant, then click the Jev icon. The side panel opens.
-
Save your OpenRouter key in the panel. Paste it at the top and click Save.
The side panel before a key is saved -
Optional: say who they are to you. Type it into Who are they to you? in the panel. It saves as you type.
-
Analyze a chat. Open a chat and click Analyze this chat. The panel shows what Jev read, their mood, and three replies. Fill puts one in the message box.
The side panel after Analyze (fictional chat)
The gear in the panel holds your key, auto-analyze, and a link to model settings. If Chrome turns the extension off after an update, turn it back on in chrome://extensions.
Firefox instead of Chrome
Open about:debugging#/runtime/this-firefox, click Load Temporary Add-on…, and pick manifest.json inside the unzipped jev-assistant-extension folder. Click the Jev icon to open the sidebar, then paste the key there. Firefox removes a temporary add-on when it quits, so load it again after a restart.
Firefox: Load Temporary Add-on… → manifest.json
Use one of these if you can't turn on Developer mode in Chrome. Neither one fills the message box. You copy the reply and paste it yourself. Each keeps its own copy of your key, saved on the Jev page.
No install. Works in Chrome or Edge on Instagram, WhatsApp Web, Snapchat Web, and Google Messages.
- Open the Jev page.
- Save your OpenRouter key in step 1 on that page. The box closes and shows the last four characters.
- Press Ctrl+Shift+B to show the bookmarks bar, then drag the purple Jev tag at the top of the page onto it.
- Open a chat and click the Jev bookmark.
A Jev tab opens with the chat as bubbles, the moods, and three replies. Click Copy, go back to the chat, and press Ctrl+V. To say who they are to you, open Other ways, and who they are to you at the bottom of the Jev page.
Use this for any other chat window. On the Jev page, save your key, open Other ways, and who they are to you, and click Read a window. Pick the chat window from the list. Jev reads one picture of it and doesn't keep it.
Why is it called Jev, and which API key do I need?
Jev is TypeSafe's judgment model, typesafe/jev-1.13. It answers structured questions about mood, intent, and risk, then ranks the three drafts. A normal chat model writes the reply text.
OpenRouter hosts that model. One OpenRouter key (sk-or-v1-…), created at openrouter.ai/keys, pays for the judge call and the draft call. A TypeSafe account is only for advanced settings, if you point the judge URL at TypeSafe yourself. The default setup stays on OpenRouter.
Will it send messages for me?
No. Fill only puts the reply in the message box. You press send.
Where does the chat text go?
Only to OpenRouter, with your key, when you analyze. Jev has no server of its own.
Should I use the app or the Chrome extension on a Mac?
The menu-bar app reads more: Apple Messages, WhatsApp Desktop, and any chat in Chrome or Firefox. Use the Chrome extension if you only chat in Chrome and don't want to build the app. You don't need both.
Why does the Chrome extension need Developer mode?
Chrome only installs extensions without Developer mode when they come from the Chrome Web Store, and Jev isn't listed there yet. The Jev bookmark works without it.
Does it cost money?
Jev is free. OpenRouter charges for the model calls on your key. Set a credit limit when you create the key.
It says the key needs more credit.
Add credit at openrouter.ai/settings/credits, or switch to a :free model.
Can I use it on my phone?
Android (11 or newer): download the APK on the phone and open it. Paste the key in Settings → Judge API, then turn on Accessibility and Display over other apps. This APK is the older v1.3 build without mood or the WhatsApp and Snapchat readers. For those, build from source with ./gradlew assembleDebug.
iPhone doesn't let apps read other apps' chats. Open the Jev page in Safari, open Other ways, paste the chat with Me: and Her: lines, and copy a reply back.
What do the risk, mood, and reply rankings mean?
- Risk is 0 to 9. Green is safe, amber means careful, red means a wrong reply could hurt.
- Mood shows the three most likely moods, highest first, each with a percent, for example
Angry 70%,Furious 20%,Frustrated 10%. The latest message counts most. - What they want is the model's read of their intent.
- Replies are ranked. The top one is the model's pick.
The default models are paid OpenRouter models. To spend less, pick a model id ending in :free in settings.
Which chats does it read?
| Chat | Mac | Windows | Android |
|---|---|---|---|
| iMessage / SMS | Apple Messages | Google Messages for web | Google Messages |
| WhatsApp Desktop, WhatsApp Web | WhatsApp Web | ||
| instagram.com Direct | instagram.com Direct | ||
| Snapchat | Snapchat Web | Snapchat Web | Snapchat |
| QQ, X, Feishu | Yes | ||
| Any other chat | Read a window | Read screen once, which can't tell who sent what |
Jev only reads chats already open on your own device.
How is a suggestion made?
open chat → read the recent messages (right side = you)
→ Jev (typesafe/jev-1.13 on OpenRouter) judges mood, intent, and risk
→ a chat model drafts 3 replies
→ Jev ranks those 3
→ show them
→ Fill writes the box
→ you send
One reader per app or site turns the window into a list of who said what. Everything after that is shared. To add an Android chat app, implement ChatAppAdapter in app/src/main/java/com/jev/probe/capture/ and register it in ChatCaptureService.
What doesn't it do well yet?
- The Android APK is v1.3 and lacks mood and the WhatsApp and Snapchat readers. Build from source for those.
- Group chats are read as if they were one-to-one.
- Screen reading only sees what's on screen. Windows marked secure can't be captured.
- Each Mac rebuild resets Accessibility and Screen Recording.
- Firefox temporary add-ons disappear when Firefox quits.
Code is under MIT. See also NOTICE.
This project only handles chats on your own device that you already have the right to view. Follow each app's terms and local law.