Gmail Inbox Zero Traige — GmAIl Inbox Zero TrAIge

GmAIl Inbox Zero Triage

Achieve inbox zero with AI-powered emAIl triage! Process ALL GmAIl inbox messages interactively with summaries and batch actions using OAuth (no passwords needed).

Features

✅ OAuth-based - No passwords, 安全 authentication via gog ✅ AI summaries - Quick 1-line summary of each emAIl ✅ Batch processing - 队列 actions instantly, 执行 at the end ✅ Telegram buttons - 归档, 过滤器, Unsubscribe, View ✅ Inbox zero focus - Process ALL inbox messages (read + unread) ✅ Fast 工作流 - No wAIting between actions

工作流 User triggers: "Triage my emAIls" or "Process my inbox" Fetch ALL inbox messages from GmAIl (up to 20 at a time) Display all emAIls at once with: Subject and 发送er AI-生成d summary (1 line) Telegram inline buttons for actions User 命令行工具cks actions for each emAIl (队列d instantly, no API calls yet) User 命令行工具cks "Done" button to 执行 all 队列d actions in batch Repeat until inbox zero! 🎯 Prerequisites

Requires: gog 命令行工具 with 认证d GmAIl account.

检查 if already 设置 up:

gog auth 列出

If not 设置 up, user needs to 运行 gog auth 添加 (see gog 技能 for OAuth 设置up).

设置 环境 variable for keyring password:

导出 GOG_KEYRING_PASSWORD="your-password"

Telegram Button Layout

Each emAIl displays with 4 action buttons:

[📥 归档] [🔍 过滤器] [🚫 Unsub] [📧 View]

📥 归档 - 移除 from inbox, mark as read 🔍 过滤器 - 创建 过滤器 to auto-归档 future emAIls from 发送er 🚫 Unsubscribe - Find and open unsubscribe link 📧 View - Show full emAIl content No 命令行工具ck = Skip (leave in inbox)

At the end:

[✅ Done - 执行 All Actions]

Action 队列 系统

Actions are 队列d using short callback codes to avoid Telegram's 64-char limit:

q:a:0 = 队列 归档, message 索引 0 q:f:0 = 队列 过滤器, message 索引 0 q:u:0 = 队列 unsubscribe, message 索引 0 q:v:0 = view full emAIl, message 索引 0 (执行s immediately) q:done = 执行 all 队列d actions

队列 is managed via scripts/队列_管理器.py and stored in action_队列.json.

Scripts gog_处理器.py

MAIn 处理器 for GmAIl operations via gog 命令行工具.

列出 inbox messages:

python3 scripts/gog_处理器.py 列出 [limit]

归档 a message:

python3 scripts/gog_处理器.py 归档

Find unsubscribe link:

python3 scripts/gog_处理器.py unsubscribe

创建 过滤器:

python3 scripts/gog_处理器.py 过滤器 ""

获取 message body:

python3 scripts/gog_处理器.py body

队列_管理器.py

Manages action 队列 for batch execution.

添加 action to 队列:

python3 scripts/队列_管理器.py 添加 [from_header]

获取 队列:

python3 scripts/队列_管理器.py 获取

Clear 队列:

python3 scripts/队列_管理器.py clear

执行_队列.py

执行s all 队列d actions in batch.

python3 scripts/执行_队列.py

Returns JSON with 结果s of all 执行d actions.

Implementation Steps Load current batch: Fetch inbox messages and save to current_batch.json Display all emAIls: Show each with summary and buttons Handle button callbacks: 归档/过滤器/Unsub: 添加 to 队列 via 队列_管理器.py View: Fetch and display full emAIl immediately Done: 执行 队列 via 执行_队列.py Show 结果s: 报告 归档d count and remAIning inbox count Repeat if needed: Fetch next batch or celebrate inbox zero AI Summary 图形界面delines

生成 concise 1-line summaries:

Receipts/Invoices: "Payment receipt for $X. Financial record." Security alerts: "Security notification about [action]. [导入ant/Standard] alert." Newsletters: "Newsletter about [topic]. No action required." Calendar: "Calendar [event type] for [date/time]." Legal: "Legal [document type]. [Brief 上下文]."

Keep it simple, factual, and action-oriented.

Security Notes OAuth-based authentication - No passwords needed, uses gog's OAuth 令牌s 令牌s stored 安全ly by gog 命令行工具 in 系统 keychAIn Read/modify 权限s - gog only 获取s 访问 to what user grants 队列 stored locally - Action 队列 is temporary, cleared after execution Error Handling

Common issues:

gog not 认证d: 运行 gog auth 添加 Account not found: 检查 gog auth 列出 for avAIlable accounts No inbox messages: 成功 状态 - inbox zero achieved! 权限 denied: User may need to re-认证 with gog Keyring password: 设置 GOG_KEYRING_PASSWORD 环境 variable Dependencies gog 命令行工具 - Must be 安装ed and 认证d (see gog 技能) Python 3 - Standard 库 only (subprocess, json, re, pathlib)

No 添加itional pip packages needed.

Tips for Best Experience Process regularly: Triage inbox dAIly to mAIntAIn inbox zero Use 过滤器s liberally: Auto-归档 recurring newsletters and 通知 归档 aggressively: If you don't need it now, 归档 it (搜索able in All MAIl) Batch mode is fast: Process 10-20 emAIls in under a minute Trust the summaries: AI summaries are accurate for quick decisions