首页 / AI Trending / googleworkspace/cli

cli 是什么？

Google Workspace CLI（gws）是一个统一的命令行工具，覆盖 Drive、Gmail、Calendar、Sheets、Docs、Chat、Admin 等几乎所有 Google Workspace API，面向人类与 AI 智能体使用：零样板、结构化 JSON 输出，并内置 40+ 个 Agent 技能。它不内置静态命令列表，而是在运行时读取 Google 的 Discovery Service 动态构建整套命令——Google 新增 API/方法时 gws 自动获得。许可为 Apache-2.0，Rust，约 26,522 stars。需明确：README 注明这不是 Google 官方支持的产品，且仍在积极开发、会有破坏性变更。

⭐ 31,291 Stars 🍴 1,861 Forks Rust Apache-2.0 作者: googleworkspace 商业引流：低
来源：官方 README 与文档入口 查看 GitHub 仓库 →

为什么值得关注

用脚本或 AI 智能体操作 Google Workspace 通常要逐个 API 写认证与请求样板，繁琐。gws 用一个 CLI、结构化 JSON 输出、动态覆盖全 Workspace API，并自带 40+ Agent 技能，对自动化与让 AI 操作 Workspace 很省事；用 Rust 写、可作为 Gemini CLI 扩展，因而受关注。截至数据采集约 26,522 stars。需提示：它非 Google 官方支持产品、仍在快速演进。

来源：官方 README 与文档入口

核心功能

统一覆盖全 Workspace API

一个 CLI 操作 Drive/Gmail/Calendar/Sheets/Docs/Chat/Admin 等所有 Workspace API，零样板。

来源：官方 README 与文档入口
Discovery 动态命令

运行时读取 Google Discovery Service 动态构建命令，Google 新增 API/方法自动可用，无需手动更新。

来源：官方 README 与文档入口
结构化 JSON + 40+ Agent 技能

输出结构化 JSON、对 AI 智能体友好，内置 40+ Agent 技能（可作 Gemini CLI 扩展等）。

来源：官方 README 与文档入口
OAuth2 认证

用 OAuth2 与你自己的 Google 账号（需 Google Cloud 项目获取凭证），可用 gws auth setup 配置。

来源：官方 README 与文档入口

技术架构

gws 是 Rust 编写的 CLI，核心特点是「动态命令面」：运行时读取 Google Discovery Service 自动构建对 Drive/Gmail/Calendar/Sheets/Docs/Chat/Admin 等所有 Workspace API 的命令，无需为新增 API 手动更新。输出结构化 JSON、对 AI 友好，并内置 40+ Agent 技能（可作为 Gemini CLI 扩展等）。认证用 OAuth2（需一个 Google Cloud 项目获取凭证，可经 Console/gcloud 或 gws auth setup 配置）与你自己的 Google 账号。安装推荐从 GitHub Releases 下预编译二进制放进 PATH，或用 npm 自动下载。需 Node.js 18+（npm 安装时）。

来源：官方 README 与文档入口

项目知识图谱

知识图谱：项目核心节点（中心）+ 核心功能（内环六边形）+ 关键技术依赖（外环 chip） Google Workspace API + Discovery ServiceGoogle Workspa… OAuth2 + Google Cloud 项目OAuth2 + Googl… Node.js 18+（npm 安装时）Node.js 18+（n… 统一覆盖全 Workspace API统一覆盖全 Workspace… Discovery 动态命令 结构化 JSON + 40+ Agent 技能结构化 JSON + 40+ A… OAuth2 认证 cli 项目本体 核心功能 关键依赖

技术栈

语言Rust框架动态构建的 CLI（基于 Google Discovery Service）
关键依赖
Google Workspace API + Discovery Ser…OAuth2 + Google Cloud 项目Node.js 18+（npm 安装时）
基础设施 / 部署
预编译二进制（GitHub Releases）或 npm 安装；可作 Gemini CLI 扩展
来源：官方 README 与文档入口

快速上手

推荐从 GitHub Releases 下对应 OS 的预编译二进制 gws 放进 PATH；也可 npm install -g @googleworkspace/cli（需 Node.js 18+）。需要一个 Google Cloud 项目获取 OAuth 凭证（可经 Console/gcloud 或 gws auth setup 配置），用你自己的 Google 账号认证。之后即可用 gws 对各 Workspace API 发命令、拿结构化 JSON；AI 智能体可用其内置 40+ 技能或作为 Gemini CLI 扩展。注意：它非 Google 官方支持产品、仍在积极开发会有破坏性变更，生产使用需谨慎。
来源：官方 README 与文档入口

使用场景

适合要脚本化或用 AI 智能体操作自己 Google Workspace 的人：自动化 Drive/Gmail/Calendar/Sheets/Docs/Chat/Admin 等任务、用结构化 JSON 接入脚本与 Agent、或把它当 Gemini CLI 扩展让 AI 直接调用 Workspace。动态命令面意味着无需等工具适配新 API。用自己的 Google 账号 + OAuth，按 Google 条款使用；因非官方且快速演进，生产前需评估稳定性。

来源：官方 README 与文档入口

优势与局限

优势

  • 一个 CLI 覆盖全 Workspace API，零样板、结构化 JSON、对 AI 友好
  • Discovery 动态构建命令，新 API 自动可用，免等适配
  • 内置 40+ Agent 技能、可作 Gemini CLI 扩展，Rust 实现、Apache-2.0
  • 用自己的 Google 账号 + OAuth，认证标准

局限

  • 非 Google 官方支持产品，仍在积极开发、会有破坏性变更
  • 需自建 Google Cloud 项目配置 OAuth，初次设置有步骤
  • 使用受 Google API 配额与服务条款约束
  • 动态命令面强大但学习/发现命令需熟悉 Workspace API
来源：官方 README 与文档入口

最新版本

本页未列出具体版本号；项目处于积极开发、迈向 v1.0（会有破坏性变更），通过 GitHub Releases 发布预编译二进制。因采用 Discovery 动态构建，命令面随 Google Workspace API 演进自动更新；技能与 Gemini CLI 扩展等持续完善。

来源：官方 README 与文档入口

总结评价

Google Workspace CLI（gws）很巧妙：用一个 Rust CLI、靠 Discovery Service 动态构建命令覆盖全 Workspace API，零样板、结构化 JSON、对 AI 友好，还内置 40+ Agent 技能、可作 Gemini CLI 扩展。对要脚本化或让 AI 操作自己 Google Workspace 的人很省事，且新 API 自动可用。要清楚它非 Google 官方支持产品、仍快速演进有破坏性变更、需自建 Cloud 项目配 OAuth、受 API 配额/条款约束。作为统一的 Workspace 自动化 CLI，它设计聪明、对 Agent 友好，但稳定性需随其迈向 v1.0 再评估。

来源：官方 README 与文档入口
资料与核验范围
本文依据项目公开资料整理。版本、安装命令和功能边界可能随上游更新，请以所列来源和项目当前版本为准。 资料核对时间: 2026-05-24 14:58.

参考材料：README、GitHub API、依赖文件