gog

SkillCommunication

Google Workspace CLI for Gmail, Calendar, Drive, Contacts, Sheets, and Docs.

Available today. Use it from your connected AI after setup.

No other account needed.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the gog skill

What this skill tells your AI

The instructions your AI receives, as published by qianleigood/crawclaw in skills-optional/gog/SKILL.md and read by ahel’s review.

Use gog for Gmail/Calendar/Drive/Contacts/Sheets/Docs. Requires OAuth setup.

Setup (once)

gog auth credentials /path/to/client_secret.json
gog auth add you@gmail.com --services gmail,calendar,drive,contacts,sheets,docs
gog auth list

Common commands

Gmail search: gog gmail search 'newer_than:7d' --max 10
Gmail send: gog gmail send --to a@b.com --subject "Hi" --body "Hello"
Calendar: gog calendar events <calendarId> --from <iso> --to <iso>
Drive search: gog drive search "query" --max 10
Contacts: gog contacts list --max 20
Sheets get: gog sheets get <sheetId> "Tab!A1:D10" --json
Sheets update: gog sheets update <sheetId> "Tab!A1:B2" --values-json '[["A","B"],["1","2"]]' --input USER_ENTERED
Sheets append: gog sheets append <sheetId> "Tab!A:C" --values-json '[["x","y","z"]]' --insert INSERT_ROWS
Sheets clear: gog sheets clear <sheetId> "Tab!A2:Z"
Sheets metadata: gog sheets metadata <sheetId> --json
Docs export: gog docs export <docId> --format txt --out /tmp/doc.txt
Docs cat: gog docs cat <docId>

Notes

Set GOG_ACCOUNT=you@gmail.com to avoid repeating --account.
For scripting, prefer --json plus --no-input.
Sheets values can be passed via --values-json (recommended) or as inline rows.
Docs supports export/cat/copy. In-place edits require a Docs API client (not in gog).
Confirm before sending mail or creating events.

默认执行模式：主会话编排，子代理只负责读、查、预检、草拟、汇总等前后处理；真正的关键执行动作仍留在主会话。
子代理可做的事：读取现状、跑预检、整理参数、生成任务摘要、批量查询、拉取结果、汇总分析、给出推荐动作。
必须留在主会话的事：外部发送、远端写入、权限/配置修改、登录授权、绑定当前聊天、创建定时或持续运行任务、真实计费提交。
若技能自身已有后台机制（如 dispatcher / watcher / queue / monitor），子代理只做前后处理，不替代原生后台执行链路。
回报节点：默认保留“计划确认 / 预检结果 / 关键动作已执行 / 已完成 / 已失败”这类高价值节点。

Advanced