Monitor topics of interest and proactively alert when important developments occur. Use when user wants automated monitoring of specific subjects (e.g., product releases, price changes, news topics, technology updates). Supports scheduled web searches, AI-powered importance scoring, smart alerts vs weekly digests, and memory-aware contextual summaries.
Monitor topics of interest and proactively alert when important developments occur. Use when user wants automated monitoring of specific subjects (e.g., product releases, price changes, news topics, technology updates). Supports scheduled web searches, AI-powered importance scoring, smart alerts vs weekly digests, and memory-aware contextual summaries.
Proactive Research
Monitor what matters. Get notified when it happens.
Proactive Research transforms your assistant from reactive to proactive by continuously monitoring topics you care about and intelligently alerting you only when something truly matters.
Core Capabilities
Topic Configuration - Define subjects with custom parameters
Scheduled Monitoring - Automated searches at configurable intervals
AI Importance Scoring - Smart filtering: immediate alert vs digest vs ignore
Contextual Summaries - Not just links—meaningful summaries with context
Weekly Digest - Low-priority findings compiled into readable reports
Memory Integration - References your past conversations and interests
Quick Start
# Initialize configcp config.example.json config.json
# Add a topic
python3 scripts/manage_topics.py add "Dirac Live updates" \
--keywords "Dirac Live,room correction,audio" \
--frequency daily \
--importance medium
# Test monitoring (dry run)
python3 scripts/monitor.py --dry-run
# Set up cron for automatic monitoring
python3 scripts/setup_cron.py
Topic Configuration
Each topic has:
name - Display name (e.g., "AI Model Releases")
query - Search query (e.g., "new AI model release announcement")
importance_threshold - high (alert immediately), medium (alert if important), low (digest only)
channels - Where to send alerts (["telegram", "discord"])
context - Why you care (for AI contextual summaries)
Example config.json
{"topics":[{"id":"ai-models","name":"AI Model Releases","query":"new AI model release GPT Claude Llama","keywords":["GPT","Claude","Llama","release","announcement"],"frequency":"daily","importance_threshold":"high","channels":["telegram"],"context":"Following AI developments for work","alert_on":["model_release","major_update"]},{"id":"tech-news","name":"Tech Industry News","query":"technology startup funding acquisition","keywords":["startup","funding","Series A","acquisition"],"frequency":"daily","importance_threshold":"medium","channels":["telegram"],"context":"Staying informed on tech trends","alert_on":["major_funding","acquisition"]},{"id":"security-alerts","name":"Security Vulnerabilities","query":"CVE critical vulnerability security patch","keywords":["CVE","vulnerability","security","patch","critical"],"frequency":"hourly","importance_threshold":"high","channels":["telegram","email"],"context":"DevOps security monitoring","alert_on":["critical_cve","zero_day"]}],"settings":{"digest_day":"sunday","digest_time":"18:00","max_alerts_per_day":5,"deduplication_window_hours":72,"learning_enabled":true}}
Scripts
manage_topics.py
Manage research topics:
# Add topic
python3 scripts/manage_topics.py add "Topic Name" \
--query "search query" \
--keywords "word1,word2" \
--frequency daily \
--importance medium \
--channels telegram
# List topics
python3 scripts/manage_topics.py list
# Edit topic
python3 scripts/manage_topics.py edit eth-price --frequency hourly
# Remove topic
python3 scripts/manage_topics.py remove eth-price
# Test topic (preview results without saving)
python3 scripts/manage_topics.py test eth-price
monitor.py
Main monitoring script (run via cron):
# Normal run (alerts + saves state)
python3 scripts/monitor.py
# Dry run (no alerts, shows what would happen)
python3 scripts/monitor.py --dry-run
# Force check specific topic
python3 scripts/monitor.py --topic eth-price
# Verbose logging
python3 scripts/monitor.py --verbose
How it works:
Reads topics due for checking (based on frequency)
Searches using web-search-plus or built-in web_search
Scores each result with AI importance scorer
High-importance → immediate alert
Medium-importance → saved for digest
Low-importance → ignored
Updates state to prevent duplicate alerts
digest.py
Generate weekly digest:
# Generate digest for current week
python3 scripts/digest.py
# Generate and send
python3 scripts/digest.py --send
# Preview without sending
python3 scripts/digest.py --preview
Output format:
# Weekly Research Digest - [Date Range]## 🔥 Highlights-**AI Models**: Claude 4.5 released with improved reasoning
-**Security**: Critical CVE patched in popular framework
## 📊 By Topic### AI Model Releases- [3 findings this week]
### Security Vulnerabilities- [1 finding this week]
## 💡 Recommendations
Based on your interests, you might want to monitor:
- "Kubernetes security" (mentioned 3x this week)
setup_cron.py
Configure automated monitoring:
# Interactive setup
python3 scripts/setup_cron.py
# Auto-setup with defaults
python3 scripts/setup_cron.py --auto
# Remove cron jobs
python3 scripts/setup_cron.py --remove
Creates cron entries:
# Proactive Research - Hourly topics
0 * * * * cd /path/to/skills/proactive-research && python3 scripts/monitor.py --frequency hourly
# Proactive Research - Daily topics
0 9 * * * cd /path/to/skills/proactive-research && python3 scripts/monitor.py --frequency daily
# Proactive Research - Weekly digest
0 18 * * 0 cd /path/to/skills/proactive-research && python3 scripts/digest.py --send
AI Importance Scoring
The scorer uses multiple signals to decide alert priority:
Scoring Signals
HIGH priority (immediate alert):
Major breaking news (detected via freshness + keyword density)
Price changes >10% (for finance topics)
Product releases matching your exact keywords
Security vulnerabilities in tools you use
Direct answers to specific questions you asked
MEDIUM priority (digest-worthy):
Related news but not urgent
Minor updates to tracked products
Interesting developments in your topics
Tutorial/guide releases
Community discussions with high engagement
LOW priority (ignore):
Duplicate news (already alerted)
Tangentially related content
Low-quality sources
Outdated information
Spam/promotional content
Learning Mode
When enabled (learning_enabled: true), the system:
Tracks which alerts you interact with
Adjusts scoring weights based on your behavior
Suggests topic refinements
Auto-adjusts importance thresholds
Learning data stored in .learning_data.json (privacy-safe, never shared).
Memory Integration
Proactive Research connects to your conversation history:
Example alert:
🔔 Dirac Live Update
Version 3.8 released with the room correction improvements you asked about last week.
Context: You mentioned struggling with bass response in your studio. This update includes new low-frequency optimization.
[Link] | [Full details]
How it works:
Reads references/memory_hints.md (create this file)
Scans recent conversation logs (if available)
Matches findings to past context
Generates personalized summaries
memory_hints.md (optional)
Help the AI connect dots:
# Memory Hints for Proactive Research## AI Models- Using Claude for coding assistance
- Interested in reasoning improvements
- Comparing models for different use cases
## Security- Running production Kubernetes clusters
- Need to patch critical CVEs quickly
- Interested in zero-day disclosures
## Tech News- Following startup ecosystem
- Interested in developer tools space
- Tracking potential acquisition targets
