你是否厌倦了在 Google Workspace(原 G Suite)的十几个网页应用间反复切换?是否想用脚本自动归档邮件、批量下载网盘文件、创建会议日程,却苦于每个 API 都要单独鉴权、写不同 SDK、处理不同响应格式?gws 就是为此而生——它不是某个功能的 CLI 小工具,而是真正意义上「一套命令,统管全部 Google 服务」的现代化命令行入口。基于 Rust 构建,零配置即可连接 Drive、Gmail、Calendar、Sheets、Docs、Chat、Admin 控制台等 20+ 服务,所有命令动态生成、随 Google 官方 API 实时进化,连 Gemini AI 扩展能力也已深度集成。
核心功能
- 全服务统一入口:无需为每个 Google 产品安装不同工具——一条命令调用 Drive 文件列表、Gmail 搜索邮件、Calendar 创建事件、Sheets 读写数据、Docs 导出 PDF、Chat 发送消息、Admin 查询用户,全部原生支持
- API 自动发现,永不过时:不依赖硬编码命令列表,启动时实时拉取 Google 官方 Discovery Service 元数据,Google 新增 API 接口或字段,gws 下次运行即自动识别并提供对应子命令
- AI 代理就绪(Agent-Ready):内置 40+ 预置「AI 技能(Agent Skills)」,如「把上周所有含附件的邮件转存到 Drive」、「根据会议邀请自动生成日程摘要并发送给团队」,可直接供 LLM 工作流调用,也可作为自动化脚本基石
- 开发者友好输出:默认返回结构化 JSON,天然适配 jq、Python、Node.js 等下游处理;同时支持 –format=table / –format=markdown 等人类可读视图,兼顾调试与汇报场景
- 开箱即用的身份认证:内置 OAuth2 流程,首次运行自动打开浏览器完成授权,令牌安全本地存储;支持服务账号(Service Account)模式,满足企业级自动化部署需求
- 轻量跨平台,开箱即用:单二进制发布(Linux/macOS/Windows 均支持),无 Node.js/Python 运行时依赖;安装后仅约 15MB,启动毫秒级响应
适合哪些人用
如果你是以下角色之一,gws 将极大提升你的 Google 生产力:IT 管理员(批量管理用户、设备、安全策略);效率极客与自动化爱好者(用 Bash/Python 脚本串联多服务任务);开发者与 SRE 工程师(CI/CD 中集成 Gmail 通知、Drive 备份、Admin 审计日志导出);AI 应用构建者(将 Google Workspace 深度接入 LLM Agent 工作流,赋予 AI「真实办公能力」);甚至普通知识工作者——只需记住几条高频命令(如 gws drive ls、gws gmail search "invoice after:2024-06-01"),就能告别鼠标点点点。
快速上手
安装仅需一行命令(推荐使用 npm,亦支持 Homebrew、Cargo 或直接下载二进制):
npm install -g @googleworkspace/cli
首次运行任意命令(如 gws drive ls),将自动打开浏览器完成 OAuth2 授权;之后所有操作均无需重复登录。查看可用服务:gws list;获取某服务帮助:gws gmail --help;执行典型任务:gws sheets read --spreadsheet-id=xxx --range="A1:C10"。完整文档与技能示例见项目 README,所有命令均支持 --json 和 --dry-run 安全预演。
项目信息
Google Workspace CLI — one command-line tool for Drive, Gmail, Calendar, Sheets, Docs, Chat, Admin, and more. Dynamically built from Google Discovery
25.2k
Stars
1.3k
Forks
Rust
Apache-2.0
编程语言:Rust|GitHub Star 数:25,195|开源协议:Apache-2.0|GitHub 项目地址
这不是 Google 官方支持的产品,但却是目前社区最活跃、设计最前沿、对 AI 时代工作流最友好的 Google Workspace 命令行解决方案——它让「用终端办公」第一次在 Google 生态中变得自然、可靠且充满可能性。


