| name | gog |
| description | Google Workspace CLI for Gmail, Calendar, Drive, Contacts, Sheets, and Docs. |
| metadata | {"crawclaw":{"emoji":"🎮","requires":{"bins":["gog"]},"install":[{"id":"brew","kind":"brew","formula":"steipete/tap/gogcli","bins":["gog"],"label":"Install gog (brew)"}]}} |
gog
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),子代理只做前后处理,不替代原生后台执行链路。
- 回报节点:默认保留“计划确认 / 预检结果 / 关键动作已执行 / 已完成 / 已失败”这类高价值节点。