# googleworkspace-cli を Homebrew, MacPorts, pacman, Nix, winget でインストール

googleworkspace-cli のインストール経路、実行ファイル、メタデータ、AI エージェント向けセキュリティノートを確認します。

## インストール

```sh
sudo av install brew:googleworkspace-cli
```

追加のインストールコマンド:

### macOS

- Homebrew (100%):

```sh
brew install googleworkspace-cli
```

  証拠: local Homebrew formula metadata

- MacPorts (94%):

```sh
sudo port install googleworkspace-cli
```

  証拠: MacPorts ports tree: office/googleworkspace-cli/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1

### Linux

- pacman (92%):

```sh
sudo pacman -S googleworkspace-cli
```

  証拠: Arch Linux sync databases: googleworkspace-cli from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz

- Nix (92%):

```sh
nix profile install nixpkgs#gws
```

  証拠: nixpkgs package indexes: pkgs/by-name/gw/gws/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

### Windows

- winget (92%):

```sh
winget install --id Google.WorkspaceCLI -e
```

  証拠: Windows Package Manager source index: Google.WorkspaceCLI from https://cdn.winget.microsoft.com/cache/source.msix

## パッケージ情報

- **パッケージキー:** brew:googleworkspace-cli
- **パッケージマネージャ:** Homebrew
- **バージョン:** 0.22.5
- **ソース概要:** CLI for Drive, Gmail, Calendar, Sheets, Docs, Chat, Admin, and more
- **ホームページ:** <https://developers.google.com/workspace>
- **リポジトリ:** <https://github.com/googleworkspace/cli>
- **生成日時:** 2026-08-03T19:37:03+00:00

## 実行可能ファイル

- gws (エイリアス)

## インストール挙動

- Bottle: 利用不可

## バージョンと鮮度

- ページ生成日: 2026-08-03
- マネージャ版: 0.22.5
## プロジェクトの歴史と使われ方

Google Workspace CLI, invoked as `gws`, is a command-line tool for Google Workspace APIs such as Drive, Gmail, Calendar, Sheets, Docs, Chat, and Admin. Its README describes a dynamic command surface built from Google's Discovery Service, structured JSON output, and included agent skills.

### プロジェクトの歴史

The GitHub repository was created in March 2026 and began with rapid 0.x releases. The README explicitly says the project is not an officially supported Google product while placing it in the Google Workspace developer ecosystem.

The tool is written for both human CLI users and AI-agent workflows. Its installation paths include prebuilt GitHub release binaries, npm distribution as `@googleworkspace/cli`, source builds with Cargo, Nix, and Homebrew.

### 採用の歴史

Because the project is young, its adoption history is mainly packaging and workflow positioning rather than a long ecosystem record. The official README documents Homebrew installation, npm installation, a Nix flake, Gemini CLI extension setup, and Skills installation from the repository.

### 使われ方

Typical use starts with `gws auth setup` or `gws auth login`, then commands such as listing Drive files, creating Sheets resources, sending Chat messages, or inspecting generated schemas. The README documents OAuth credential files, exported credentials for headless use, pre-obtained access tokens, and environment-variable precedence.

### パッケージ好きにとっての重要性

For package nerds, gws is interesting because it packages a broad API family as a generated CLI rather than hand-written subcommands. It also reflects a 2026-era packaging pattern: one binary, npm bootstrap, Homebrew formula, Nix flake, structured JSON output, and agent skill bundles.

### タイムライン

- 2026: GitHub repository created under googleworkspace/cli.
- 2026: 0.1.2 published on GitHub Releases in March.
- 2026: 0.22.5 published on GitHub Releases in March after a rapid 0.x release series.
- 2026: Homebrew formula and npm installation documented in the README.

### Related projects

- The README relates gws to Google Workspace APIs, Google's Discovery Service, Google Cloud OAuth setup, the gcloud CLI, Gemini CLI extensions, and repository-provided agent skills.

### ソース

- <https://api.github.com/repos/googleworkspace/cli>
- <https://developers.google.com/workspace>
- <https://github.com/googleworkspace/cli>
- <https://github.com/googleworkspace/cli#readme>
- <https://github.com/googleworkspace/cli/releases>


## セキュリティノート

narrow executable package without higher-risk signals.

- **Geiger リスク:** グリーン / 低
- narrow executable package without higher-risk signals


## Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.


## Credential files

- Unix: ~/.config/gws/client_secret.json, ~/.config/gws/credentials.json, $GOOGLE_WORKSPACE_CLI_CREDENTIALS_FILE
## 他のパッケージマネージャ記録

- pacman - googleworkspace-cli - 0.22.5-1: normalized package name match | Arch Linux sync databases: googleworkspace-cli from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz | Command-line tool for Drive, Gmail, Calendar, Sheets, Docs, Chat, Admin, and more | https://developers.google.com/workspace
- MacPorts - googleworkspace-cli: normalized package name match | MacPorts ports tree: office/googleworkspace-cli/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1
- MacPorts - gws: installed executable or alias match | MacPorts ports tree: devel/gws/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1
- Nix - gws: installed executable or alias match | nixpkgs package indexes: pkgs/by-name/gw/gws/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- winget - Google.WorkspaceCLI: installed executable or alias match | Windows Package Manager source index: Google.WorkspaceCLI from https://cdn.winget.microsoft.com/cache/source.msix


## Combined YAML source

View the package source record on GitHub. [combined/googleworkspace-cli.yml](https://github.com/mxcl/pkgdb/blob/main/combined/googleworkspace-cli.yml)


## ソース

- pkg.so package database
- Geiger risk classifier
- curated configuration and credential file locations
- curated package history
- pkgdb category and tag curation
- external package-manager database matches
- cross-ecosystem install command graph
