gogcli 是一款专为 Google Workspace 生态系统设计的命令行工具，旨在让用户能够直接从终端高效管理 Gmail、日历、云端硬盘（Drive）、表格、文档、幻灯片、联系人、任务、人员、群组和 Keep 笔记等核心服务。通过简洁的命令行接口，它打破了传统图形化操作的限制，为开发者、系统管理员和高级用户提供了自动化与批量处理 Google Workspace 资源的便捷途径。该工具支持 OAuth 2.0 身份验证机制，确保安全访问个人账户数据，并将凭证本地加密存储于 `~/.config/gog/` 目录中，兼顾功能性与隐私保护。
作为一款开源项目（托管于 GitHub），gogcli 允许用户从源码自行编译安装，也支持通过 Homebrew 快速部署。其设计注重脚本友好性，所有命令均提供 `–json` 输出选项，便于集成到自动化流程或与其他工具链协同工作。无论是日常邮件检索、日程同步，还是大规模文件管理与协作内容导出，gogcli 都能以统一、一致的语法简化跨平台操作，显著提升工作效率。
首次使用前需完成 OAuth 客户端配置：在 Google Cloud Console 创建桌面应用类型的 OAuth 凭证，并指定回调地址为 `http://localhost:8085/callback`。随后通过 `gog auth add` 命令绑定账户与密钥文件即可开始使用。整个设置过程清晰明确，即使是非技术背景用户也能在几分钟内完成初始配置，正式进入高效的命令行管理模式。
核心功能特点
- 支持 Gmail、日历、Drive、Sheets、Docs、Slides、Contacts、Tasks、People、Groups 和 Keep 等全部主流 Google Workspace 服务
- 采用统一的命令行语法，提供搜索、发送、列表、创建、上传、导出等标准化操作指令
- 内置 OAuth 2.0 认证体系，自动管理令牌刷新与本地安全存储
- 支持 JSON 格式输出，便于集成到 shell 脚本或 CI/CD 自动化流程中
- 可通过 Homebrew 一键安装，或从源码构建并全局部署
- 完全离线可用，无需依赖浏览器或第三方 GUI 界面
适用场景
gogcli 特别适合需要频繁与 Google Workspace 进行交互但又不愿打开网页界面的场景。例如，系统管理员可以编写脚本定期扫描未读邮件并自动归档，或将日历事件同步至外部调度系统；远程工作者可通过命令行快速上传日志文件至云端硬盘，并在不同设备间保持文档一致性。对于开发者而言，利用 `–json` 参数获取结构化数据后，可轻松对接内部监控面板或通知服务，实现告警自动化。此外，在处理大量联系人或批量导出表格时，命令行操作比手动点击节省数倍时间，尤其适用于数据迁移、审计或合规检查等高强度任务。
在日常办公环境中，gogcli 同样表现出色。用户可以在终端直接搜索特定关键词的邮件、创建临时会议邀请，或将重要文档一键转为 PDF 格式保存。结合快捷键和别名功能，资深用户甚至能构建个人效率工作流——比如在启动开发环境前自动检查待办任务状态，或在每日站会前导出团队共享表格的最新进度。由于所有操作均在本地终端完成，网络延迟和浏览器性能问题不再构成瓶颈，响应速度远超 Web 版本。同时，其轻量化特性意味着对硬件资源消耗极低，适合在服务器、树莓派或低配设备上长期运行。
更进阶的应用包括将 gogcli 嵌入自动化运维平台，实现无人值守的内容分发与资源清理；或为团队协作定制专属 CLI 工具链，统一成员的操作规范与输出格式。无论是个人生产力提升还是企业级流程优化，gogcli 都以其灵活性、可扩展性和无侵入式集成能力，成为连接终端用户与 Google Workspace 的强大桥梁。