README.md

September 20, 2026 · View on GitHub

🔮 jev-notion

Fill Notion database properties with calibrated AI judgments.
Second-level latency (≤2s) • Micro-cent cost (\$0.00004/row) • Native macOS App (SwiftUI) + CLI • Zero Server.

📦 Download macOS App (2.8MB) • ⚡ Run in Terminal • 🌐 8-Language Preview • 📊 Benchmarks

English • 简体中文

⚡ Highlights

Feature	Description
⚡ Second-Level Latency (≤ 2s)	Adaptive polling catches row edits in under 2 seconds — beating Notion's 5-minute webhook queues.
🎯 Calibrated Probabilities	Jev returns typed outputs with mathematical confidence ( $\ge 60\%$ ). Uncertain entries go to a review queue — no silent hallucinations.
💰 Micro-Cent Pricing	~$0.00004 per row ($0.042 / 1M input tokens, free output). 10,000 rows costs around forty cents.
🖥️ Native macOS Client (SwiftUI)	Crafted in pure SwiftUI with Notion's iconic 9-color palette, Jev real-time telemetry HUD, and interactive card drawer.
🌐 8-Language Dynamic Localization	Instant hot-switching between 8 languages with zero application restart required.
🔐 Keychain Hardware Security	Credentials stored encrypted in Apple Keychain; zero plaintext tokens on disk.
🛠️ Universal CLI & Engine Library	Fully autonomous terminal workflow (`npx jev-notion`) or embeddable TypeScript engine.

📊 Battle-Tested Benchmarks

Feature	jev-notion	Notion Native AI	Custom Webhook Server
Cost	~$0.00004 / row (40¢ / 10k rows)	$10 / user / month	Server hosting + LLM bills
Output Type	Calibrated Probabilities ( $\ge 60\%$ )	Plain text (guesses)	Plain text (guesses)
Detection Speed	≤ 2 seconds	Manual trigger	1 – 5 minutes (aggregated)
Review Queue	Native Visual Cards	None (overwrites)	None (needs custom UI)
Client UI	Native macOS SwiftUI App	Web/Electron only	None
Multilingual	8 Languages Hot-Switching	System default	English only
Self-Hosted	100% Yours (MIT)	Proprietary SaaS	High maintenance

🌐 8-Language Dynamic Localization Showcase

Experience seamless, real-time hot-switching across 8 world languages. Click any language tab below to see full-resolution macOS app screenshots:

🇺🇸 English (Default) — Click to expand

🇨🇳 简体中文 (Simplified Chinese) — Click to expand

🇭🇰 繁體中文 (Traditional Chinese) — Click to expand

🇯🇵 日本語 (Japanese) — Click to expand

🇰🇷 한국어 (Korean) — Click to expand

🇫🇷 Français (French) — Click to expand

🇩🇪 Deutsch (German) — Click to expand

🇪🇸 Español (Spanish) — Click to expand

📦 Quick Download (macOS App)

Download the ultra-lightweight 2.8 MB pre-compiled app:

Download JevNotion-v0.1.0-macOS.zip.
Unzip and drag JevNotion.app to your /Applications folder.
Launch JevNotion and enter your Notion & Jev credentials in Settings (⌘,).

⚡ Quick Start (CLI)

Prefer running from your terminal or a remote server?

1. Setup Keys

Create an internal integration at notion.so/profile/integrations and get a Jev key from typesafe.ai. Put them in .env:

NOTION_TOKEN=ntn_...
TYPESAFE_API_KEY=ts_...

2. Run

# Automated one-command sync
npx jev-notion

# Read-only inspection (prints suggestions without writing)
npx jev-notion scan

# Apply approved suggestions from JSON
npx jev-notion apply

# Install as a background launchd daemon (macOS)
npx jev-notion install

🏗️ Architecture

                                  ┌────────────────────────┐
                                  │ Notion Database Table  │
                                  └───────────┬────────────┘
                                              │ (≤2s Polling)
                                              ▼
┌───────────────────────┐         ┌────────────────────────┐
│ Native macOS Client   │ ◄─────► │   jev-notion Core      │
│ (SwiftUI + 8-Lang)    │         │  (Token Bucket Limiter)│
└───────────────────────┘         └───────────┬────────────┘
                                              │ Typed Evidence
                                              ▼
                                  ┌────────────────────────┐
                                  │   Jev Precision Model  │
                                  │  (Calibrated Prob >=60)│
                                  └───────────┬────────────┘
                                              │ Atomic Writes
                                              ▼
                                  ┌────────────────────────┐
                                  │ Notion Properties Set  │
                                  └────────────────────────┘

🤝 Contributing

Contributions are welcome! Please check out CONTRIBUTING.md for development setup, running tests (npm test, 269 tests), and compiling the macOS app (./app/build.sh).

📄 License

_{⭐ If you find jev-notion useful, please consider giving it a star on GitHub!}