googleworkspace/cli

GWS

Один CLI для всего Google Workspace — созданный для людей и AI-агентов.
Drive, Gmail, Календарь и все API Workspace. Нет стандартных стандартов. Структурированный JSON-вывод. Включено 40+ навыков агента.

[! ПРИМЕЧАНИЕ] Это не официально поддерживаемый продукт Google.

⬇️ Скачайте последний релиз для вашей ОС

gws не поставляет статический список команд. Он читает собственный сервис поиска Google во время выполнения и динамически строит всю свою командную поверхность. Когда Google Workspace добавляет конечную точку или метод API, gws автоматически его забирает.

[! ВАЖНО] Этот проект находится в активной разработке. Ожидайте резких изменений по мере приближения к версии 1.0.

Содержание

• Предварительные требования
• Установка
• Быстрый старт
• Почему GWS?
• Аутентификация
• Навыки агента ИИ
• Расширенное использование
• Переменные среды
• Коды выходов
• Архитектура
• Устранение неисправностей
• Разработка

Предварительные требования

• Node.js 18+ — для npm install (или скачать готовый бинарный файл с GitHub Releases)
• Проект Google Cloud — требуется для учётных данных OAuth. Вы можете создать его через Google Cloud Console, с помощью CLI gcloud или команды gws auth setup.

gws

One CLI for all of Google Workspace — built for humans and AI agents. Drive, Gmail, Calendar, and every Workspace API. Zero boilerplate. Structured JSON output. 40+ agent skills included.

[!NOTE] This is not an officially supported Google product.

⬇️ Download the latest release for your OS

gws doesn’t ship a static list of commands. It reads Google’s own Discovery Service at runtime and builds its entire command surface dynamically. When Google Workspace adds an API endpoint or method, gws picks it up automatically.

[!IMPORTANT] This project is under active development. Expect breaking changes as we march toward v1.0.

Contents

• Prerequisites
• Installation
• Quick Start
• Why gws?
• Authentication
• AI Agent Skills
• Advanced Usage
• Environment Variables
• Exit Codes
• Architecture
• Troubleshooting
• Development

Prerequisites

• Node.js 18+ — for npm install (or download a pre-built binary from GitHub Releases)
• A Google Cloud project — required for OAuth credentials. You can create one via the Google Cloud Console or with the gcloud CLI or with the gws auth setup command.
• A Google account with access to Google Workspace

Installation

The recommended way to install gws is to download the pre-built binary for your OS and architecture from the GitHub Releases page. Extract the archive and place the gws binary in your $PATH.

For convenience, you can also use npm to automate downloading the appropriate binary from GitHub Releases:

npm install -g @googleworkspace/cli

Or build from source:

cargo install --git https://github.com/googleworkspace/cli --locked

A Nix flake is also available at github:googleworkspace/cli