/setup-gogcli

description: "Lesson command"
duration: "約15分"
prerequisites: ["Googleアカウントを持っている", "ブラウザが使える"]
level: "beginner"
tags: ["setup", "gogcli", "google", "gmail", "calendar", "oauth"]
nonInteractiveMode: incompatible

gogcli (Google Workspace CLI) セットアップ

Step 0: セットアップ進捗の確認

**AIが自動実行する内容:** 1. `uv run python tools/setup_progress.py show --current setup-gogcli` を実行して進捗を表示 2. 既存のインストール・認証を自動検出:

• `which gog` または `gog --version` を実行
• gogcli がインストール済みの場合、`gog auth list` で認証状態を確認
• インストール済み＆認証済みの場合、Step 4（動作テスト）へスキップ

このセッションでやること

| 項目 | 内容 | |------|------| | ゴール | gogcli をインストールし、Google OAuth 認証を完了して、Gmail/Calendar/Drive/Sheets にCLIからアクセスできるようにする | | 所要時間 | 約15分 | | 前提条件 | Googleアカウントを持っていること、ブラウザが使えること | | 操作レベル | CLIコマンド入力なし（すべてAIが自動実行 + ブラウザでのOAuth認証のみ） |

**このセッションの流れ:** 1. gogcli をインストールする（AIが自動でOS判定・インストール） 2. Google OAuth 認証を行う（AIがコマンド実行 → ブラウザでGoogleログイン） 3. 認証済みアカウントを確認する（AIが自動実行） 4. Gmail/Calendarの動作テスト（AIが自動実行）

> **ヒント**: AIの応答が途中で止まった場合は「続きを表示して」「止まってるよ」と入力すると再開します。

---

準備チェック

**AskQuestionの設定:**

{
  "title": "セッション開始前の確認",
  "questions": [{
    "id": "readiness",
    "prompt": "準備はできていますか？",
    "options": [
      {"id": "ready", "label": "準備OK！始めましょう"},
      {"id": "check_prereq", "label": "前提条件を確認したい"},
      {"id": "different_lesson", "label": "別のレッスンに移動したい"}
    ]
  }]
}

(ready → Step 1へ) (check_prereq → 「Googleアカウントでブラウザにログインできれば準備OKです。gogcli は無料で利用でき、Google Workspace API の無料枠内で動作します」と案内) (different_lesson → モジュール一覧を表示)

---

Step 1: gogcli のインストール

**AIが実行すること:** 1. OSを自動判定する（Mac / Windows / Linux） 2. 既にインストール済みか確認する: `which gog`（Mac/Linux）または `where gog`（Windows） 3. 未インストールの場合、以下のコマンドを実行:

# Mac / Linux (Homebrew推奨):
brew install gogcli

# Windows:
# GitHub Releases から ZIP をダウンロードして gog.exe を展開し、PATH に追加
# https://github.com/steipete/gogcli/releases

# Linux代替 (Homebrew未導入の場合):
# GitHub Releases からバイナリを直接ダウンロード
# https://github.com/steipete/gogcli/releases

4. インストール後、`gog --version` で確認する

**インストール方法の判定ロジック:**

• Windows を使用している → GitHub Releases からダウンロード（https://github.com/steipete/gogcli/releases）
• `which brew` が成功 → Homebrew でインストール
• Homebrew がない場合 → Homebrew のインストールから案内（https://brew.sh）

**AskQuestionの設定:**

{
  "title": "Step 1: gogcli のインストール",
  "questions": [{
    "id": "install_status",
    "prompt": "gogcli のインストールを実行しました。結果を確認してください。",
    "options": [
      {"id": "installed", "label": "インストールできました！"},
      {"id": "brew_error", "label": "brew install でエラーが出た"},
      {"id": "no_brew", "label": "Homebrew がインストールされていない"},
      {"id": "windows", "label": "Windowsを使っている"},
      {"id": "command_not_found", "label": "gog コマンドが見つからない"}
    ]
  }]
}

(installed → Step 2へ) (brew_error → `brew update && brew install gogcli` を実行後リトライ) (no_brew → 「まずHomebrewをインストールしましょう。ブラウザで https://brew.sh を開いてインストールコマンドをコピー・実行してください」と案内) (windows → 「https://github.com/steipete/gogcli/releases からZIPをダウンロードし、gog.exe を展開してPATHの通ったフォルダに配置してください。その後ターミナルを再起動して `gog --version` を確認してください」と案内) (command_not_found → Mac/Linuxの場合: `brew link gogcli` を実行。Windowsの場合: gog.exe がPATHに追加されているか確認。それでも解決しない場合はターミナルを再起動する手順を案内)

---

Step 2: Google OAuth 認証

**AIが実行すること:** 1. ユーザーに認証に使用するGoogleアカウントのメールアドレスを確認する 2. `gog auth add <メールアドレス>` を実行する 3. ブラウザが自動で開き、Google OAuth 認証画面が表示される

**ユーザーに案内するメッセージ:**

Google OAuth 認証を開始します。

┌─────────────────────────────────────────────────────────────┐
│ ブラウザが自動で開きます。以下の手順で認証してください:     │
│                                                             │
│ 1. ブラウザでGoogleアカウントを選択（またはログイン）       │
│ 2. 「このアプリを許可しますか？」の画面で「許可」をクリック │
│ 3. 「Authorization successful」と表示されたら認証完了       │
│ 4. ターミナルに戻ってください                               │
│                                                             │
│ ※ 認証情報は gogcli により安全に保存されます               │
│   (macOS: ~/Library/Application Support/gogcli/             │
│    Linux: ~/.config/gogcli/)                                │
│ ※ APIキーの手動入力は不要です（OAuth認証で自動管理）       │
└─────────────────────────────────────────────────────────────┘

**AskQuestionの設定:**

{
  "title": "Step 2: Google OAuth 認証",
  "questions": [{
    "id": "auth_status",
    "prompt": "ブラウザでGoogleアカウントの認証を行ってください。認証できましたか？",
    "options": [
      {"id": "authenticated", "label": "認証できました！"},
      {"id": "browser_not_open", "label": "ブラウザが開かない"},
      {"id": "auth_error", "label": "認証エラーが出た"},
      {"id": "account_help", "label": "Googleアカウントの選び方がわからない"},
      {"id": "access_denied", "label": "「access denied」と表示された"}
    ]
  }]
}

(authenticated → Step 3へ) (browser_not_open → 「ターミナルに表示されたURLをコピーして、手動でブラウザに貼り付けてください」と案内) (auth_error → `gog auth add <メールアドレス>` を再実行。エラーメッセージを確認して原因を特定) (account_help → 「普段Gmailで使用しているGoogleアカウントを選択してください。会社のGoogle Workspaceアカウントでも個人のGmailアカウントでもOKです。後から別のアカウントを追加することもできます」と案内) (access_denied → 「組織のGoogle Workspaceで外部アプリへのアクセスが制限されている可能性があります。IT管理者に確認するか、個人のGmailアカウントでお試しください」と案内)

---

Step 3: アカウント確認

**AIが自動で実行すること:** 1. `gog auth list` を実行して認証済みアカウント一覧を表示 2. 正しいGoogleアカウントが表示されることを確認

**確認のAskQuestion:**

{
  "title": "Step 3: アカウント確認",
  "questions": [{
    "id": "account_check",
    "prompt": "認証済みアカウントが表示されました。正しいアカウントですか？",
    "options": [
      {"id": "correct", "label": "正しいアカウントです！"},
      {"id": "wrong_account", "label": "別のアカウントを使いたい"},
      {"id": "no_account", "label": "アカウントが表示されない"}
    ]
  }]
}

(correct → Step 4へ) (wrong_account → `gog auth add <メールアドレス>` で別のアカウントを追加する手順を案内) (no_account → Step 2に戻り、OAuth認証をやり直す)

---

Step 4: 動作テスト

**AIが自動で実行すること:**

1. `gog auth list` で認証済みアカウントのメールアドレスを取得する 2. Gmail検索テストを実行:

   gog gmail search "newer_than:1d" --account <email>

3. Calendar取得テストを実行:

   gog calendar list --account <email> --days 1

**テスト成功時:**

gogcli のセットアップが完了しました！

テスト結果:
- Gmail検索: 正常に動作しています
- Calendar取得: 正常に動作しています

これでGmail/Calendar/Drive/SheetsにCLIからアクセスできるようになりました。

**テスト失敗時のAskQuestion:**

{
  "title": "テスト結果: エラーが発生しました",
  "question