gogcli - Google Workspace CLI

核心用法

gogcli 是一款面向开发者的命令行工具，用于统一管理 Google Workspace 全系列产品。核心工作流分为三步：OAuth 认证配置 → 账户授权 → 执行操作。支持 Gmail 搜索/发送、Calendar 事件管理、Drive 文件操作、Sheets 导出、Contacts/Tasks 查询等高频场景，所有命令均支持 --json 输出便于脚本集成。

显著优点

• 全覆盖支持：单一工具覆盖 10 项 Google 服务，避免多工具切换
• 开发者友好：纯 CLI 设计，支持 JSON 输出和脚本自动化
• 来源可信：作者 steipete（Peter Steinberger）为 PSPDFKit 创始人，知名开源贡献者
• 认证规范：采用标准 OAuth 2.0 流程，Token 本地存储

潜在局限

• 配置门槛高：需手动创建 Google Cloud 项目、配置 OAuth 凭证，非技术用户难以独立完成
• 无图形界面：纯命令行交互，不适合偏好 GUI 的用户
• 依赖外部工具：需自行安装/编译，无一键安装包（除 Homebrew）
• 权限范围宽：Google Workspace API 授权通常请求广泛的数据访问权限

适合人群

• 开发者/DevOps 工程师需要批量处理 Google 服务数据
• 习惯终端工作流的技术用户
• 需自动化邮件、日程、文档管理的工作场景

常规风险

• OAuth 凭证泄露风险：client_secret.json 文件需妥善保管
• sudo 提权提示：安装文档包含 sudo make install，需确认来源可信后执行
• 本地端口暴露：OAuth 回调使用 localhost:8085，需确保该端口未被恶意占用
• 数据误操作：CLI 工具无二次确认，删除/覆盖操作不可逆

核心用法

gogcli 是一款面向开发者和高级用户的 Google Workspace 命令行管理工具，支持 Gmail、Calendar、Drive、Sheets、Docs、Slides、Contacts、Tasks、People、Groups、Keep 等 10 余项服务。用户可通过 brew 快速安装或从源码编译，首次使用需在 Google Cloud Console 创建 OAuth 桌面应用凭证并完成本地授权。

常用场景包括：

• Gmail: 搜索邮件、发送邮件、管理标签
• Calendar: 列出事件、创建日程
• Drive: 文件列表、上传下载
• Sheets: 列出表格、导出 PDF
• Contacts & Tasks: 联系人搜索、任务管理

输出支持 --json 标志便于脚本集成，凭证本地存储于 ~/.config/gog/。

显著优点

1. 一站式服务: 单一 CLI 覆盖 Google Workspace 核心套件，无需切换多个工具
2. 开发者友好: JSON 输出、标准 Unix 管道支持，易于自动化和 CI/CD 集成
3. 本地优先: OAuth 凭证本地存储，不依赖第三方云服务，符合隐私敏感场景
4. 开源透明: 由知名开发者 steipete（PSPDFKit 创始人）维护，代码可审计

潜在局限

• 配置门槛高: 必须自行在 Google Cloud Console 配置 OAuth，对非技术用户不够友好
• 功能边界: 纯文档型 Skill，实际可执行代码需用户自行安装 gogcli 二进制
• 权限管理: 需手动管理 Google API 启用范围和 OAuth 同意屏幕
• 平台限制: 主要面向 macOS/Linux，Windows 支持依赖 WSL

适合人群

• 开发者/DevOps 工程师需要自动化 Google Workspace 操作
• 隐私意识强的用户倾向本地工具而非 Web 界面
• 已熟悉命令行工作流的效率用户

常规风险

• OAuth 凭证泄露: client_secret 文件需妥善保管，避免提交至版本控制
• sudo 提权: 全局安装需 sudo，建议仅在可信环境执行
• 本地端口暴露: OAuth 回调使用 localhost:8085，虽为正常配置但需确保无恶意程序监听