N0Mail v0.2.1 - Alpha Update Release Notes
Release Date: [April 22, 2025]
The N0Mail v0.2.1 release builds upon the alpha foundation laid in v0.2.0, introducing a powerful keyword search tool, improved performance through briefing cache, and key usability and codebase enhancements.
✨ New Features
- 🔍 Keyword Search Tool (search_email_by_keyword): Added a dedicated tool for precise keyword or phrase matching within email subjects and bodies. Especially useful for locating specific terms, IDs, or quoted text.
- The AI now intelligently chooses between semantic search and exact-match keyword search based on the user’s query type.
🚀 Improvements & Enhancements
- ⚡ Briefing Cache Enabled: The n0mail brief and n0mail chat initial briefing calls are now cached for 15 minutes. This significantly speeds up repeated invocations within a short time window.
- 📅 Default Briefing Range: The default lookback window for both n0mail brief and n0mail chat is now set to 2 days, offering more relevant recent context by default.
- 🗨️ Improved No-Result Feedback: Enhanced system prompts in chat to provide clearer, more informative messages when neither RAG nor keyword search returns a result—reducing user confusion and guiding better follow-up questions.
- 🛠️ Debug Mode Enhancements: More robust exception tracing and logging in debug mode to assist with error diagnosis during development or troubleshooting.
🔧 Refactoring & Internal Changes
- 🧠 RAG Service Refactor: The Retrieval-Augmented Generation logic has been modularized into a standalone service (rag_service), streamlining future expansion and maintenance.
- 📁 Tool Logic Modularization: Search-related tools used by the chat module (RAG, sender search, name lookup, keyword search) have been decoupled and moved into a new directory: n0mail/cli/tools/. This improves code structure and maintainability.
⸻
📌 Reminder: Usage Quick Reference
n0mail auth google
n0mail sync run [--days N | --full] [--no-embed]
n0mail process classify [--max-emails N]
n0mail process summarize [--no-skip-bulk]
n0mail brief compose | generate [--days N] [--output FILE]
n0mail chat [--chat-model MODEL] [--embedding-model MODEL]
🧭 Looking Ahead (M2 Roadmap)
The following features are still under development:
- (F-6) n0mail cron enable for automated briefing generation.
- (F-8) Interactive chat REPL commands such as /open, /copy, /retry.
- (F-9) More advanced caching and invalidation mechanisms for dynamic email content changes.