/setup-gogcli.es

description: "Lesson command"
duration: "~15 min"
prerequisites: ["Tener una cuenta de Google", "Navegador disponible"]
level: "beginner"
tags: ["setup", "gogcli", "google", "gmail", "calendar", "oauth"]
nonInteractiveMode: incompatible

Configuración de gogcli (Google Workspace CLI)

Step 0: Verificar el progreso de configuración

**Lo que la IA ejecuta automáticamente:** 1. Ejecutar `uv run python tools/setup_progress.py show --current setup-gogcli` para mostrar el progreso 2. Detectar automáticamente la instalación y autenticación existentes:

• Ejecutar `which gog` o `gog --version`
• Si gogcli ya está instalado, verificar el estado de autenticación con `gog auth list`
• Si ya está instalado y autenticado, saltar al Step 4 (prueba de funcionalidad)

Lo que hará en esta sesión

| Elemento | Contenido | |----------|-----------| | Objetivo | Instalar gogcli y completar la autenticación Google OAuth para poder acceder a Gmail/Calendar/Drive/Sheets desde la CLI | | Duración | ~15 minutos | | Requisitos previos | Tener una cuenta de Google y un navegador disponible | | Nivel de operación | No se necesitan comandos CLI (todo lo ejecuta automáticamente la IA + solo autenticación OAuth en el navegador) |

**Flujo de la sesión:** 1. Instalar gogcli (la IA detecta automáticamente el SO e instala) 2. Realizar la autenticación Google OAuth (la IA ejecuta el comando, usted inicia sesión en el navegador) 3. Verificar la cuenta autenticada (la IA lo ejecuta automáticamente) 4. Prueba de funcionalidad de Gmail/Calendar (la IA lo ejecuta automáticamente)

> **Consejo**: Si la respuesta de la IA se detiene a mitad de camino, escriba "por favor continúe" o "se detuvo" para reanudar.

---

Verificación de preparación

**Configuración de AskQuestion:**

{
  "title": "Confirmación antes de la sesión",
  "questions": [{
    "id": "readiness",
    "prompt": "¿Está preparado/a?",
    "options": [
      {"id": "ready", "label": "¡Preparado/a! Comencemos"},
      {"id": "check_prereq", "label": "Quiero verificar los requisitos previos"},
      {"id": "different_lesson", "label": "Quiero ir a otra lección"}
    ]
  }]
}

(ready -> Ir al Step 1) (check_prereq -> Indicar: "Está listo/a si puede iniciar sesión en un navegador con una cuenta de Google. gogcli es gratuito y funciona dentro de los límites del nivel gratuito de la API de Google Workspace.") (different_lesson -> Mostrar la lista de módulos)

---

Step 1: Instalar gogcli

**Lo que hace la IA:** 1. Detectar automáticamente el SO (Mac / Windows / Linux) 2. Verificar si ya está instalado: `which gog` (Mac/Linux) o `where gog` (Windows) 3. Si no está instalado, ejecutar los siguientes comandos:

# Mac / Linux (Homebrew recomendado):
brew install gogcli

# Windows:
# Descargar el ZIP desde GitHub Releases, extraer gog.exe y agregarlo al PATH
# https://github.com/steipete/gogcli/releases

# Linux alternativa (si Homebrew no está instalado):
# Descargar el binario directamente desde GitHub Releases
# https://github.com/steipete/gogcli/releases

4. Después de la instalación, verificar con `gog --version`

**Lógica de decisión del método de instalación:**

• En Windows -> Descargar desde GitHub Releases (https://github.com/steipete/gogcli/releases)
• `which brew` tiene éxito -> Instalar vía Homebrew
• Homebrew no disponible -> Guiar la instalación de Homebrew primero (https://brew.sh)

**Configuración de AskQuestion:**

{
  "title": "Step 1: Instalar gogcli",
  "questions": [{
    "id": "install_status",
    "prompt": "Se ejecutó la instalación de gogcli. Por favor verifique el resultado.",
    "options": [
      {"id": "installed", "label": "¡Se instaló correctamente!"},
      {"id": "brew_error", "label": "Obtuve un error con brew install"},
      {"id": "no_brew", "label": "Homebrew no está instalado"},
      {"id": "windows", "label": "Estoy usando Windows"},
      {"id": "command_not_found", "label": "No se encuentra el comando gog"}
    ]
  }]
}

(installed -> Ir al Step 2) (brew_error -> Ejecutar `brew update && brew install gogcli` y reintentar) (no_brew -> Indicar: "Primero instalemos Homebrew. Abra https://brew.sh en su navegador y copie/ejecute el comando de instalación.") (windows -> Indicar: "Descargue el ZIP desde https://github.com/steipete/gogcli/releases, extraiga gog.exe y colóquelo en una carpeta que esté en su PATH. Luego reinicie la terminal y verifique con `gog --version`.") (command_not_found -> Mac/Linux: Ejecutar `brew link gogcli`. Windows: verificar que gog.exe esté agregado al PATH. Si no se resuelve, guiar para reiniciar la terminal)

---

Step 2: Autenticación Google OAuth

**Lo que hace la IA:** 1. Preguntar al usuario qué correo electrónico de cuenta de Google usar para la autenticación 2. Ejecutar `gog auth add <correo electrónico>` 3. El navegador se abrirá automáticamente y mostrará la pantalla de autenticación Google OAuth

**Mensaje para mostrar al usuario:**

Iniciando la autenticación Google OAuth.

┌─────────────────────────────────────────────────────────────┐
│ El navegador se abrirá automáticamente. Siga estos pasos    │
│ para autenticarse:                                          │
│                                                             │
│ 1. Seleccione su cuenta de Google en el navegador           │
│    (o inicie sesión)                                        │
│ 2. En la pantalla "¿Permitir esta aplicación?",             │
│    haga clic en "Permitir"                                  │
│ 3. Cuando aparezca "Authorization successful",              │
│    la autenticación está completa                           │
│ 4. Regrese a la terminal                                    │
│                                                             │
│ * Las credenciales se almacenan de forma segura por gogcli  │
│   (macOS: ~/Library/Application Support/gogcli/             │
│    Linux: ~/.config/gogcli/)                                │
│ * No es ne