Other

/email-golem

Check email status, run manual triage, view recent scores. Use when asking about emails or wanting to check urgent messages.

$ golems-cli skills install email-golem

Experimental

Updated 2 weeks ago

Check status, run manual triage, view recent scores, and manage the email system.

Commands

Check Status

# View scheduler status
launchctl list | grep email-golem
 
# View recent logs
tail -20 /tmp/golems-email-golem.log
 
# View offline queue
cat ~/.local/share/brainlayer/offline-queue.json 2>/dev/null || echo "Queue empty"

Manual Run

# Dry run (safe - no DB writes, no notifications)
cd ~/Gits/golems && bun run packages/shared/src/email/index.ts --dry-run
 
# Full run (will score, save, and notify if urgent)
cd ~/Gits/golems && bun run packages/shared/src/email/index.ts
 
# Check specific number of emails
cd ~/Gits/golems && bun run packages/shared/src/email/index.ts --dry-run --max=5

Scheduler Control

# Enable (runs every 10 minutes)
launchctl load ~/Library/LaunchAgents/com.golems.email-golem.plist
 
# Disable
launchctl unload ~/Library/LaunchAgents/com.golems.email-golem.plist
 
# Reload (after changes)
launchctl unload ~/Library/LaunchAgents/com.golems.email-golem.plist
launchctl load ~/Library/LaunchAgents/com.golems.email-golem.plist

When To Use

"Check my emails" → Run dry-run to see what would be scored
"Any urgent emails?" → Run dry-run and check for score 10
"Is email checker running?" → Check launchctl status
"Why no email notifications?" → Check logs for errors

Scoring Reference

Score	Category	Action
10	interview, urgent	Telegram alert NOW
7-9	job	Morning briefing
5-6	subscription	Monthly tracking
1-4	newsletter, promo	Ignore

Full SKILL.md source — includes LLM directives, anti-patterns, and technical instructions stripped from the Overview tab.

Check status, run manual triage, view recent scores, and manage the email system.

Commands

Check Status

# View scheduler status
launchctl list | grep email-golem
 
# View recent logs
tail -20 /tmp/golems-email-golem.log
 
# View offline queue
cat ~/.local/share/brainlayer/offline-queue.json 2>/dev/null || echo "Queue empty"

Manual Run

# Dry run (safe - no DB writes, no notifications)
cd ~/Gits/golems && bun run packages/shared/src/email/index.ts --dry-run
 
# Full run (will score, save, and notify if urgent)
cd ~/Gits/golems && bun run packages/shared/src/email/index.ts
 
# Check specific number of emails
cd ~/Gits/golems && bun run packages/shared/src/email/index.ts --dry-run --max=5

Scheduler Control

# Enable (runs every 10 minutes)
launchctl load ~/Library/LaunchAgents/com.golems.email-golem.plist
 
# Disable
launchctl unload ~/Library/LaunchAgents/com.golems.email-golem.plist
 
# Reload (after changes)
launchctl unload ~/Library/LaunchAgents/com.golems.email-golem.plist
launchctl load ~/Library/LaunchAgents/com.golems.email-golem.plist

When To Use

"Check my emails" → Run dry-run to see what would be scored
"Any urgent emails?" → Run dry-run and check for score 10
"Is email checker running?" → Check launchctl status
"Why no email notifications?" → Check logs for errors

Scoring Reference

Score	Category	Action
10	interview, urgent	Telegram alert NOW
7-9	job	Morning briefing
5-6	subscription	Monthly tracking
1-4	newsletter, promo	Ignore

Troubleshooting

No emails scoring

Check Gmail credentials in .env
Check MLX backend is available: which mlx_lm.generate
Check logs: tail -50 /tmp/golems-email-golem.log

Notifications not working

Check telegram-bot is running: pgrep -fl telegram-bot
Check port 3847: curl http://localhost:3847/health

Items stuck in queue

# View queue
cat ~/.local/share/brainlayer/offline-queue.json
 
# Clear queue (if corrupt)
rm ~/.local/share/brainlayer/offline-queue.json

~/Gits/golems/packages/shared/src/email/ - Source code
~/Gits/golems/packages/shared/src/email/index.ts - Entry point
~/.local/share/brainlayer/state.json - State (lastEmailCheck, processedIds)

Requirements

Telegram bot running on port 3847 (for notifications)
MLX backend for local inference
Gmail OAuth configured
Supabase tables created

Commands

Check Status

Manual Run

Scheduler Control

When To Use

Scoring Reference

Commands

Check Status

Manual Run

Scheduler Control

When To Use

Scoring Reference

Troubleshooting

No emails scoring

Notifications not working

Items stuck in queue

Related Files

Requirements