googleworkspace/cli

解決する課題

gws は、すべての Google Workspace API（Drive、Gmail、Calendar、Sheets を含む）とやり取りするための統一された方法を提供するコマンドラインインターフェース（CLI）です。Workspace リソースを管理する際に、複雑な curl コールやボイラープレートコードを書く必要がなくなり、これらのサービスにアクセスするための構造化された開発者フレンドリーな方法を提供します。

仕組み

gws は、静的なコマンドリストを同梱するのではなく、Google の Discovery Service を読み取ることで、実行時にコマンド・サーフェスを動的に構築します。これにより、Google が新しい API エンドポイントやメソッドを追加するたびに、アップデートを必要とせずに CLI が自動的にそれを取り込みます。サービスを特定し、キャッシュされた Discovery Document に基づいてコマンドツリーを構築するために、2段階のパース戦略を使用しています。

対象ユーザー

• 開発者およびパワーユーザー: 自動ページネーション、--dry-run プレビュー、組み込みのヘルプなどの機能を使用して、ターミナル経由で Google Workspace を管理したい方。
• AI エージェント: すべてのレスポンスが構造化された JSON であるため、カスタムの統合コードを必要とせずに LLM が Workspace タスクを管理するためのツールとして使用できるように設計されています。

ハイライト

• 動的な API サーフェス: Google の Discovery Service に基づいてコマンドを自動的に更新します。
• AI 対応: LLM が一般的なワークフローを実行できるように、100 以上の「Agent Skills」（厳選されたレシピとヘルパー）が含まれています。
• 構造化された出力: すべての成功およびエラーレスポンスは、解析しやすい JSON として返されます。
• 包括的な認証: インタラクティブなログイン、サービスアカウント、取得済みのアクセストークンを含む、複数の認証ワークフローをサポートしています。
• ヘルパーコマンド: メールの送信やカレンダーイベントの作成などの一般的なタスクに対して、人間にとって使いやすい専用のショートカット（+ で始まる）を提供します。
• セキュリティ統合: Google Cloud Model Armor と統合し、API レスポンスがエージェントに届く前にプロンプトインジェクション対策としてサニタイズします。