Prompt file imported from minicoohei/ai-agent-camp (.cursor/commands/lesson/start-4-1.es.md). Copyright stays with the author.

🎓 Lesson 4-1: Configuracion de autenticacion de gogcli

Name: start-4-1.es
Author: minicoohei

📍 Lo que hara en esta sesion

Bienvenido a Lesson 4-1: Configuracion de autenticacion de gogcli

Elemento	Detalles
Objetivo	Autenticarse con una cuenta de Google usando gogcli para habilitar Gmail/Calendar/Drive
Duracion	~25 min
Skills utilizados	gogcli (gog)
Requisitos previos	Configuracion del entorno completada (start-0-1 finalizado)

Flujo de la sesion:

Verificar la instalacion de gogcli
Agregar una cuenta de Google mediante autenticacion OAuth
Verificar el estado de autenticacion y prueba de operacion basica

Al finalizar esta sesion, gogcli tendra acceso a Gmail, Calendar y Drive.

💡 Consejo: Si la respuesta de la IA se detiene a mitad de camino, escriba "por favor continua" o "se detuvo" para reanudar. Este es un comportamiento de Cursor, no un error.

🎯 Verificacion de preparacion

Verifiquemos que todo esta listo.

Configuracion de AskQuestion:

{
  "title": "🎯 Confirmación antes de iniciar la sesión",
  "questions": [{
    "id": "readiness",
    "prompt": "¿Está listo/a?",
    "options": [
      {"id": "ready", "label": "¡Listo! 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 → Ejecutar verificacion de requisitos previos) (different_lesson → Mostrar lista de modulos)

🚀 Step 1: Verificar instalacion de gogcli

Use AskUserQuestion (AskQuestion) para elegir "Continuar / Solo revisar ejemplos / Omitir."

Ejemplo de configuracion de AskQuestion:

{
  "title": "🚀 Step 1: Verificar la instalacion de gogcli",
  "questions": [{
    "id": "step_action",
    "prompt": "¿Qué desea hacer con este paso?",
    "options": [
      {"id": "practice", "label": "Continuar tal cual"},
      {"id": "review", "label": "Solo revisar ejemplos"},
      {"id": "skip", "label": "Omitir"}
    ]
  }]
}

Despues de la seleccion (ejemplo):

Verifique que gogcli esta instalado. Ejecute los siguientes comandos:

# Verificar version
gog --version

# Si no esta instalado
brew install gogcli
# Si Homebrew no esta disponible, descargue de GitHub Releases:
# https://github.com/steipete/gogcli/releases

Resultado esperado: Se muestra el numero de version de gogcli (por ejemplo, gog version 0.x.x).

📝 Nota: gogcli no requiere crear un cliente OAuth en la consola de GCP. Utiliza credenciales OAuth integradas para la autenticacion, lo que hace que la configuracion sea muy sencilla.

🚀 Step 2: Agregar cuenta de Google via OAuth

Use AskUserQuestion (AskQuestion) para elegir "Continuar / Solo revisar ejemplos / Omitir."

Ejemplo de configuracion de AskQuestion:

{
  "title": "🚀 Step 2: Agregar una cuenta de Google mediante autenticacion OAuth",
  "questions": [{
    "id": "step_action",
    "prompt": "¿Qué desea hacer con este paso?",
    "options": [
      {"id": "practice", "label": "Continuar tal cual"},
      {"id": "review", "label": "Solo revisar ejemplos"},
      {"id": "skip", "label": "Omitir"}
    ]
  }]
}

Despues de la seleccion (ejemplo):

Autentique su cuenta de Google. Ejecute el siguiente comando:

# Agregar cuenta de Google (se abrira el navegador)
gog auth add your-email@gmail.com

Pasos:

Al ejecutar el comando, el navegador se abrira automaticamente
Inicie sesion con su cuenta de Google
Apruebe los permisos de acceso para gogcli (Gmail, Calendar, Drive, Sheets, etc.)
Una vez que se muestre "Autenticacion completada", puede cerrar el navegador

# Verificar lista de cuentas autenticadas
gog auth list

# Verificar subcomandos disponibles
gog --help

Resultado esperado: gog auth list muestra su direccion de correo electronico.

⚠️ Advertencia: Las credenciales de autenticacion se almacenan de forma segura en su maquina local. Los tokens se almacenan en el directorio .gog/.

🚀 Step 3: Prueba de operacion basica

Use AskUserQuestion (AskQuestion) para elegir "Continuar / Solo revisar ejemplos / Omitir."

Ejemplo de configuracion de AskQuestion:

{
  "title": "🚀 Step 3: Prueba de operacion basica",
  "questions": [{
    "id": "step_action",
    "prompt": "¿Qué desea hacer con este paso?",
    "options": [
      {"id": "practice", "label": "Continuar tal cual"},
      {"id": "review", "label": "Solo revisar ejemplos"},
      {"id": "skip", "label": "Omitir"}
    ]
  }]
}

Despues de la seleccion (ejemplo):

Verifique que cada servicio esta funcionando correctamente:

# Gmail: Buscar los 5 correos mas recientes
gog gmail search "newer_than:1d" --account your-email@gmail.com

# Calendar: Listar los eventos de hoy
gog calendar list --account your-email@gmail.com --days 1

# Drive: Listar archivos en la carpeta raiz
gog drive ls --account your-email@gmail.com --max 5

Resultado esperado: Se muestran datos de Gmail/Calendar/Drive con cada comando. Si no aparecen errores, la autenticacion se ha completado exitosamente.

💡 Consejo: El indicador --account es obligatorio para todos los comandos de gogcli. Debe especificar su direccion de correo electronico cada vez.

⚠️ Problemas comunes y soluciones

Ejemplo de configuracion de AskQuestion:

{
  "title": "Seleccione el problema",
  "questions": [{
    "id": "trouble",
    "prompt": "Seleccione la opción que corresponda",
    "options": [
      {"id": "trouble_1", "label": "No se puede instalar gogcli"},
      {"id": "trouble_2", "label": "El navegador no se abre"},
      {"id": "trouble_3", "label": "No se puede acceder despues de la autenticacion"},
      {"id": "trouble_4", "label": "Error de permiso denegado"}
    ]
  }]
}

Problema 1: "No se puede instalar gogcli"

Causa: Homebrew no esta instalado o PATH no esta configurado Prompt de solucion:

Verifique el metodo de instalacion de gogcli.
Si Homebrew esta disponible, intente brew install gogcli.
Si Homebrew no esta disponible, descargue el binario de https://github.com/steipete/gogcli/releases.

Problema 2: "El navegador no se abre"

Causa: Se esta ejecutando en un entorno remoto o sin interfaz grafica Prompt de solucion:

Copie la URL que se muestra al ejecutar gog auth add y peguelo en su navegador manualmente.
Ingrese el codigo de autenticacion en la terminal cuando se emita.

Problema 3: "No se puede acceder despues de la autenticacion"

Causa: El almacenamiento del token fallo, o alcance insuficiente Prompt de solucion:

Elimine la autenticacion con gog auth remove your-email@gmail.com,
luego vuelva a autenticarse con gog auth add your-email@gmail.com.

Problema 4: "Error de permiso denegado"

Causa: Los permisos de acceso son insuficientes en el lado de la cuenta de Google Prompt de solucion:

Verifique que las "Aplicaciones menos seguras" no esten bloqueadas en la configuracion de seguridad de su cuenta de Google.
Si un administrador de Google Workspace ha establecido restricciones de API, consulte al administrador.

✅ Punto de control

gogcli esta instalado (gog --version funciona)
La autenticacion de la cuenta de Google esta completa (gog auth list lo muestra)
La busqueda de Gmail funciona (gog gmail search muestra correos)
El listado del calendario funciona (gog calendar list muestra eventos)
El listado de archivos de Drive funciona (gog drive ls muestra archivos)

📋 Vista previa de resultados

El entregable de esta leccion es la salida de la terminal.

Salida esperada

┌─────────────────────────────────────┐
│  Resultado de ejecución del comando    │
│  Estado: ✅ Éxito                       │
│  Elementos procesados: N               │
└─────────────────────────────────────┘

Consejo: Para guardar la salida en un archivo, agregue > output/result.txt al final del comando

✅ Verificacion de finalizacion

Pegue lo siguiente en el chat de Codex para verificar la finalizacion:

Ejecute los siguientes comandos para verificar el estado de autenticacion de gogcli:
1. gog auth list
2. gog gmail search "newer_than:1d" --account <su-correo>
3. gog calendar list --account <su-correo> --days 1
Verifique que todos los comandos funcionen correctamente.

Resultado esperado: Los tres comandos se ejecutan sin errores.

🎉 Siguientes pasos

La configuracion de autenticacion de gogcli esta completa! En la siguiente leccion, aprendera busqueda y visualizacion de Gmail.

Ejemplo de configuracion de AskQuestion:

{
  "title": "Seleccione el siguiente paso",
  "questions": [{
    "id": "next_step",
    "prompt": "Seleccione la siguiente acción",
    "options": [
      {"id": "next_auto", "label": "Iniciar la siguiente sección (/start-4-2)"},
      {"id": "next_window", "label": "Iniciar en nueva ventana (/start-4-2)"},
      {"id": "finish", "label": "Finalizar aquí"}
    ]
  }]
}

Despues de la seleccion (ejemplo):

next_auto → /start-4-2（Busqueda y visualizacion de Gmail)
next_window → Abrir nueva ventana con /start-4-2
finish → Finalizar

# 🎓 Lesson 4-1: Configuracion de autenticacion de gogcli ## 📍 Lo que hara en esta sesion Bienvenido a **Lesson 4-1: Configuracion de autenticacion de gogcli** | Elemento | Detalles | |----------|----------| | Objetivo | Autenticarse con una cuenta de Google usando gogcli para habilitar Gmail/Calendar/Drive | | Duracion | ~25 min | | Skills utilizados | gogcli (gog) | | Requisitos previos | Configuracion del entorno completada (start-0-1 finalizado) | **Flujo de la sesion:** 1. Verificar la instalacion de gogcli 2. Agregar una cuenta de Google mediante autenticacion OAuth 3. Verificar el estado de autenticacion y prueba de operacion basica Al finalizar esta sesion, gogcli tendra acceso a Gmail, Calendar y Drive. > **💡 Consejo**: Si la respuesta de la IA se detiene a mitad de camino, escriba "por favor continua" o "se detuvo" para reanudar. Este es un comportamiento de Cursor, no un error. --- ## 🎯 Verificacion de preparacion Verifiquemos que todo esta listo. **Configuracion de AskQuestion:** ```json { "title": "🎯 Confirmación antes de iniciar la sesión", "questions": [{ "id": "readiness", "prompt": "¿Está listo/a?", "options": [ {"id": "ready", "label": "¡Listo! 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 → Ejecutar verificacion de requisitos previos) (different_lesson → Mostrar lista de modulos) --- ## 🚀 Step 1: Verificar instalacion de gogcli Use AskUserQuestion (AskQuestion) para elegir "Continuar / Solo revisar ejemplos / Omitir." **Ejemplo de configuracion de AskQuestion:** ```json { "title": "🚀 Step 1: Verificar la instalacion de gogcli", "questions": [{ "id": "step_action", "prompt": "¿Qué desea hacer con este paso?", "options": [ {"id": "practice", "label": "Continuar tal cual"}, {"id": "review", "label": "Solo revisar ejemplos"}, {"id": "skip", "label": "Omitir"} ] }] } ``` **Despues de la seleccion (ejemplo)**: Verifique que gogcli esta instalado. Ejecute los siguientes comandos: ```bash # Verificar version gog --version # Si no esta instalado brew install gogcli # Si Homebrew no esta disponible, descargue de GitHub Releases: # https://github.com/steipete/gogcli/releases ``` **Resultado esperado**: Se muestra el numero de version de gogcli (por ejemplo, `gog version 0.x.x`). > **📝 Nota**: gogcli no requiere crear un cliente OAuth en la consola de GCP. Utiliza credenciales OAuth integradas para la autenticacion, lo que hace que la configuracion sea muy sencilla. --- ## 🚀 Step 2: Agregar cuenta de Google via OAuth Use AskUserQuestion (AskQuestion) para elegir "Continuar / Solo revisar ejemplos / Omitir." **Ejemplo de configuracion de AskQuestion:** ```json { "title": "🚀 Step 2: Agregar una cuenta de Google mediante autenticacion OAuth", "questions": [{ "id": "step_action", "prompt": "¿Qué desea hacer con este paso?", "options": [ {"id": "practice", "label": "Continuar tal cual"}, {"id": "review", "label": "Solo revisar ejemplos"}, {"id": "skip", "label": "Omitir"} ] }] } ``` **Despues de la seleccion (ejemplo)**: Autentique su cuenta de Google. Ejecute el siguiente comando: ```bash # Agregar cuenta de Google (se abrira el navegador) gog auth add your-email@gmail.com ``` **Pasos:** 1. Al ejecutar el comando, el navegador se abrira automaticamente 2. Inicie sesion con su cuenta de Google 3. Apruebe los permisos de acceso para gogcli (Gmail, Calendar, Drive, Sheets, etc.) 4. Una vez que se muestre "Autenticacion completada", puede cerrar el navegador ```bash # Verificar lista de cuentas autenticadas gog auth list # Verificar subcomandos disponibles gog --help ``` **Resultado esperado**: `gog auth list` muestra su direccion de correo electronico. > **⚠️ Advertencia**: Las credenciales de autenticacion se almacenan de forma segura en su maquina local. Los tokens se almacenan en el directorio `.gog/`. --- ## 🚀 Step 3: Prueba de operacion basica Use AskUserQuestion (AskQuestion) para elegir "Continuar / Solo revisar ejemplos / Omitir." **Ejemplo de configuracion de AskQuestion:** ```json { "title": "🚀 Step 3: Prueba de operacion basica", "questions": [{ "id": "step_action", "prompt": "¿Qué desea hacer con este paso?", "options": [ {"id": "practice", "label": "Continuar tal cual"}, {"id": "review", "label": "Solo revisar ejemplos"}, {"id": "skip", "label": "Omitir"} ] }] } ``` **Despues de la seleccion (ejemplo)**: Verifique que cada servicio esta funcionando correctamente: ```bash # Gmail: Buscar los 5 correos mas recientes gog gmail search "newer_than:1d" --account your-email@gmail.com # Calendar: Listar los eventos de hoy gog calendar list --account your-email@gmail.com --days 1 # Drive: Listar archivos en la carpeta raiz gog drive ls --account your-email@gmail.com --max 5 ``` **Resultado esperado**: Se muestran datos de Gmail/Calendar/Drive con cada comando. Si no aparecen errores, la autenticacion se ha completado exitosamente. > **💡 Consejo**: El indicador `--account` es obligatorio para todos los comandos de gogcli. Debe especificar su direccion de correo electronico cada vez. --- ## ⚠️ Problemas comunes y soluciones **Ejemplo de configuracion de AskQuestion:** ```json { "title": "Seleccione el problema", "questions": [{ "id": "trouble", "prompt": "Seleccione la opción que corresponda", "options": [ {"id": "trouble_1", "label": "No se puede instalar gogcli"}, {"id": "trouble_2", "label": "El navegador no se abre"}, {"id": "trouble_3", "label": "No se puede acceder despues de la autenticacion"}, {"id": "trouble_4", "label": "Error de permiso denegado"} ] }] } ``` ### Problema 1: "No se puede instalar gogcli" **Causa**: Homebrew no esta instalado o PATH no esta configurado **Prompt de solucion**: ```text Verifique el metodo de instalacion de gogcli. Si Homebrew esta disponible, intente brew install gogcli. Si Homebrew no esta disponible, descargue el binario de https://github.com/steipete/gogcli/releases. ``` ### Problema 2: "El navegador no se abre" **Causa**: Se esta ejecutando en un entorno remoto o sin interfaz grafica **Prompt de solucion**: ```text Copie la URL que se muestra al ejecutar gog auth add y peguelo en su navegador manualmente. Ingrese el codigo de autenticacion en la terminal cuando se emita. ``` ### Problema 3: "No se puede acceder despues de la autenticacion" **Causa**: El almacenamiento del token fallo, o alcance insuficiente **Prompt de solucion**: ```text Elimine la autenticacion con gog auth remove your-email@gmail.com, luego vuelva a autenticarse con gog auth add your-email@gmail.com. ``` ### Problema 4: "Error de permiso denegado" **Causa**: Los permisos de acceso son insuficientes en el lado de la cuenta de Google **Prompt de solucion**: ```text Verifique que las "Aplicaciones menos seguras" no esten bloqueadas en la configuracion de seguridad de su cuenta de Google. Si un administrador de Google Workspace ha establecido restricciones de API, consulte al administrador. ``` --- ## ✅ Punto de control - [ ] gogcli esta instalado (`gog --version` funciona) - [ ] La autenticacion de la cuenta de Google esta completa (`gog auth list` lo muestra) - [ ] La busqueda de Gmail funciona (`gog gmail search` muestra correos) - [ ] El listado del calendario funciona (`gog calendar list` muestra eventos) - [ ] El listado de archivos de Drive funciona (`gog drive ls` muestra archivos) --- ## 📋 Vista previa de resultados El entregable de esta leccion es la salida de la terminal. ### Salida esperada ```text ┌─────────────────────────────────────┐ │ Resultado de ejecución del comando │ │ Estado: ✅ Éxito │ │ Elementos procesados: N │ └─────────────────────────────────────┘ ``` > Consejo: Para guardar la salida en un archivo, agregue ` > output/result.txt` al final del comando --- ## ✅ Verificacion de finalizacion Pegue lo siguiente en el chat de Codex para verificar la finalizacion: ```text Ejecute los siguientes comandos para verificar el estado de autenticacion de gogcli: 1. gog auth list 2. gog gmail search "newer_than:1d" --account <su-correo> 3. gog calendar list --account <su-correo> --days 1 Verifique que todos los comandos funcionen correctamente. ``` **Resultado esperado**: Los tres comandos se ejecutan sin errores. --- ## 🎉 Siguientes pasos La configuracion de autenticacion de gogcli esta completa! En la siguiente leccion, aprendera busqueda y visualizacion de Gmail. **Ejemplo de configuracion de AskQuestion:** ```json { "title": "Seleccione el siguiente paso", "questions": [{ "id": "next_step", "prompt": "Seleccione la siguiente acción", "options": [ {"id": "next_auto", "label": "Iniciar la siguiente sección (/start-4-2)"}, {"id": "next_window", "label": "Iniciar en nueva ventana (/start-4-2)"}, {"id": "finish", "label": "Finalizar aquí"} ] }] } ``` **Despues de la seleccion (ejemplo)**: - next_auto → /start-4-2（Busqueda y visualizacion de Gmail) - next_window → Abrir nueva ventana con /start-4-2 - finish → Finalizar

{ "prompt": "# 🎓 Lesson 4-1: Configuracion de autenticacion de gogcli\n\n## 📍 Lo que hara en esta sesion\n\nBienvenido a **Lesson 4-1: Configuracion de autenticacion de gogcli**\n\n| Elemento | Detalles |\n|----------|----------|\n| Objetivo | Autenticarse con una cuenta de Google usando gogcli para habilitar Gmail/Calendar/Drive |\n| Duracion | ~25 min |\n| Skills utilizados | gogcli (gog) |\n| Requisitos previos | Configuracion del entorno completada (start-0-1 finalizado) |\n\n**Flujo de la sesion:**\n1. Verificar la instalacion de gogcli\n2. Agregar una cuenta de Google mediante autenticacion OAuth\n3. Verificar el estado de autenticacion y prueba de operacion basica\n\nAl finalizar esta sesion, gogcli tendra acceso a Gmail, Calendar y Drive.\n\n> **💡 Consejo**: Si la respuesta de la IA se detiene a mitad de camino, escriba \"por favor continua\" o \"se detuvo\" para reanudar. Este es un comportamiento de Cursor, no un error.\n\n---\n\n## 🎯 Verificacion de preparacion\n\nVerifiquemos que todo esta listo.\n\n**Configuracion de AskQuestion:**\n```json\n{\n \"title\": \"🎯 Confirmación antes de iniciar la sesión\",\n \"questions\": [{\n \"id\": \"readiness\",\n \"prompt\": \"¿Está listo/a?\",\n \"options\": [\n {\"id\": \"ready\", \"label\": \"¡Listo! Comencemos\"},\n {\"id\": \"check_prereq\", \"label\": \"Quiero verificar los requisitos previos\"},\n {\"id\": \"different_lesson\", \"label\": \"Quiero ir a otra lección\"}\n ]\n }]\n}\n```\n\n(ready → Ir al Step 1)\n(check_prereq → Ejecutar verificacion de requisitos previos)\n(different_lesson → Mostrar lista de modulos)\n\n---\n\n## 🚀 Step 1: Verificar instalacion de gogcli\n\nUse AskUserQuestion (AskQuestion) para elegir \"Continuar / Solo revisar ejemplos / Omitir.\"\n\n**Ejemplo de configuracion de AskQuestion:**\n```json\n{\n \"title\": \"🚀 Step 1: Verificar la instalacion de gogcli\",\n \"questions\": [{\n \"id\": \"step_action\",\n \"prompt\": \"¿Qué desea hacer con este paso?\",\n \"options\": [\n {\"id\": \"practice\", \"label\": \"Continuar tal cual\"},\n {\"id\": \"review\", \"label\": \"Solo revisar ejemplos\"},\n {\"id\": \"skip\", \"label\": \"Omitir\"}\n ]\n }]\n}\n```\n\n**Despues de la seleccion (ejemplo)**:\n\nVerifique que gogcli esta instalado. Ejecute los siguientes comandos:\n\n```bash\n# Verificar version\ngog --version\n\n# Si no esta instalado\nbrew install gogcli\n# Si Homebrew no esta disponible, descargue de GitHub Releases:\n# https://github.com/steipete/gogcli/releases\n```\n\n**Resultado esperado**: Se muestra el numero de version de gogcli (por ejemplo, `gog version 0.x.x`).\n\n> **📝 Nota**: gogcli no requiere crear un cliente OAuth en la consola de GCP. Utiliza credenciales OAuth integradas para la autenticacion, lo que hace que la configuracion sea muy sencilla.\n\n---\n\n## 🚀 Step 2: Agregar cuenta de Google via OAuth\n\nUse AskUserQuestion (AskQuestion) para elegir \"Continuar / Solo revisar ejemplos / Omitir.\"\n\n**Ejemplo de configuracion de AskQuestion:**\n```json\n{\n \"title\": \"🚀 Step 2: Agregar una cuenta de Google mediante autenticacion OAuth\",\n \"questions\": [{\n \"id\": \"step_action\",\n \"prompt\": \"¿Qué desea hacer con este paso?\",\n \"options\": [\n {\"id\": \"practice\", \"label\": \"Continuar tal cual\"},\n {\"id\": \"review\", \"label\": \"Solo revisar ejemplos\"},\n {\"id\": \"skip\", \"label\": \"Omitir\"}\n ]\n }]\n}\n```\n\n**Despues de la seleccion (ejemplo)**:\n\nAutentique su cuenta de Google. Ejecute el siguiente comando:\n\n```bash\n# Agregar cuenta de Google (se abrira el navegador)\ngog auth add your-email@gmail.com\n```\n\n**Pasos:**\n1. Al ejecutar el comando, el navegador se abrira automaticamente\n2. Inicie sesion con su cuenta de Google\n3. Apruebe los permisos de acceso para gogcli (Gmail, Calendar, Drive, Sheets, etc.)\n4. Una vez que se muestre \"Autenticacion completada\", puede cerrar el navegador\n\n```bash\n# Verificar lista de cuentas autenticadas\ngog auth list\n\n# Verificar subcomandos disponibles\ngog --help\n```\n\n**Resultado esperado**: `gog auth list` muestra su direccion de correo electronico.\n\n> **⚠️ Advertencia**: Las credenciales de autenticacion se almacenan de forma segura en su maquina local. Los tokens se almacenan en el directorio `.gog/`.\n\n---\n\n## 🚀 Step 3: Prueba de operacion basica\n\nUse AskUserQuestion (AskQuestion) para elegir \"Continuar / Solo revisar ejemplos / Omitir.\"\n\n**Ejemplo de configuracion de AskQuestion:**\n```json\n{\n \"title\": \"🚀 Step 3: Prueba de operacion basica\",\n \"questions\": [{\n \"id\": \"step_action\",\n \"prompt\": \"¿Qué desea hacer con este paso?\",\n \"options\": [\n {\"id\": \"practice\", \"label\": \"Continuar tal cual\"},\n {\"id\": \"review\", \"label\": \"Solo revisar ejemplos\"},\n {\"id\": \"skip\", \"label\": \"Omitir\"}\n ]\n }]\n}\n```\n\n**Despues de la seleccion (ejemplo)**:\n\nVerifique que cada servicio esta funcionando correctamente:\n\n```bash\n# Gmail: Buscar los 5 correos mas recientes\ngog gmail search \"newer_than:1d\" --account your-email@gmail.com\n\n# Calendar: Listar los eventos de hoy\ngog calendar list --account your-email@gmail.com --days 1\n\n# Drive: Listar archivos en la carpeta raiz\ngog drive ls --account your-email@gmail.com --max 5\n```\n\n**Resultado esperado**: Se muestran datos de Gmail/Calendar/Drive con cada comando. Si no aparecen errores, la autenticacion se ha completado exitosamente.\n\n> **💡 Consejo**: El indicador `--account` es obligatorio para todos los comandos de gogcli. Debe especificar su direccion de correo electronico cada vez.\n\n---\n\n## ⚠️ Problemas comunes y soluciones\n\n**Ejemplo de configuracion de AskQuestion:**\n```json\n{\n \"title\": \"Seleccione el problema\",\n \"questions\": [{\n \"id\": \"trouble\",\n \"prompt\": \"Seleccione la opción que corresponda\",\n \"options\": [\n {\"id\": \"trouble_1\", \"label\": \"No se puede instalar gogcli\"},\n {\"id\": \"trouble_2\", \"label\": \"El navegador no se abre\"},\n {\"id\": \"trouble_3\", \"label\": \"No se puede acceder despues de la autenticacion\"},\n {\"id\": \"trouble_4\", \"label\": \"Error de permiso denegado\"}\n ]\n }]\n}\n```\n\n### Problema 1: \"No se puede instalar gogcli\"\n**Causa**: Homebrew no esta instalado o PATH no esta configurado\n**Prompt de solucion**:\n```text\nVerifique el metodo de instalacion de gogcli.\nSi Homebrew esta disponible, intente brew install gogcli.\nSi Homebrew no esta disponible, descargue el binario de https://github.com/steipete/gogcli/releases.\n```\n\n### Problema 2: \"El navegador no se abre\"\n**Causa**: Se esta ejecutando en un entorno remoto o sin interfaz grafica\n**Prompt de solucion**:\n```text\nCopie la URL que se muestra al ejecutar gog auth add y peguelo en su navegador manualmente.\nIngrese el codigo de autenticacion en la terminal cuando se emita.\n```\n\n### Problema 3: \"No se puede acceder despues de la autenticacion\"\n**Causa**: El almacenamiento del token fallo, o alcance insuficiente\n**Prompt de solucion**:\n```text\nElimine la autenticacion con gog auth remove your-email@gmail.com,\nluego vuelva a autenticarse con gog auth add your-email@gmail.com.\n```\n\n### Problema 4: \"Error de permiso denegado\"\n**Causa**: Los permisos de acceso son insuficientes en el lado de la cuenta de Google\n**Prompt de solucion**:\n```text\nVerifique que las \"Aplicaciones menos seguras\" no esten bloqueadas en la configuracion de seguridad de su cuenta de Google.\nSi un administrador de Google Workspace ha establecido restricciones de API, consulte al administrador.\n```\n\n---\n\n## ✅ Punto de control\n- [ ] gogcli esta instalado (`gog --version` funciona)\n- [ ] La autenticacion de la cuenta de Google esta completa (`gog auth list` lo muestra)\n- [ ] La busqueda de Gmail funciona (`gog gmail search` muestra correos)\n- [ ] El listado del calendario funciona (`gog calendar list` muestra eventos)\n- [ ] El listado de archivos de Drive funciona (`gog drive ls` muestra archivos)\n\n\n---\n\n## 📋 Vista previa de resultados\n\nEl entregable de esta leccion es la salida de la terminal.\n\n### Salida esperada\n```text\n┌─────────────────────────────────────┐\n│ Resultado de ejecución del comando │\n│ Estado: ✅ Éxito │\n│ Elementos procesados: N │\n└─────────────────────────────────────┘\n```\n\n> Consejo: Para guardar la salida en un archivo, agregue ` > output/result.txt` al final del comando\n\n---\n\n## ✅ Verificacion de finalizacion\nPegue lo siguiente en el chat de Codex para verificar la finalizacion:\n\n```text\nEjecute los siguientes comandos para verificar el estado de autenticacion de gogcli:\n1. gog auth list\n2. gog gmail search \"newer_than:1d\" --account <su-correo>\n3. gog calendar list --account <su-correo> --days 1\nVerifique que todos los comandos funcionen correctamente.\n```\n\n**Resultado esperado**: Los tres comandos se ejecutan sin errores.\n\n---\n\n## 🎉 Siguientes pasos\n\nLa configuracion de autenticacion de gogcli esta completa! En la siguiente leccion, aprendera busqueda y visualizacion de Gmail.\n\n**Ejemplo de configuracion de AskQuestion:**\n```json\n{\n \"title\": \"Seleccione el siguiente paso\",\n \"questions\": [{\n \"id\": \"next_step\",\n \"prompt\": \"Seleccione la siguiente acción\",\n \"options\": [\n {\"id\": \"next_auto\", \"label\": \"Iniciar la siguiente sección (/start-4-2)\"},\n {\"id\": \"next_window\", \"label\": \"Iniciar en nueva ventana (/start-4-2)\"},\n {\"id\": \"finish\", \"label\": \"Finalizar aquí\"}\n ]\n }]\n}\n```\n\n**Despues de la seleccion (ejemplo)**:\n- next_auto → /start-4-2（Busqueda y visualizacion de Gmail)\n- next_window → Abrir nueva ventana con /start-4-2\n- finish → Finalizar", "variables": [], "notes": "Lesson command", "metadata": { "source": { "provider": "github-cursor-commands", "repository": "https://github.com/minicoohei/ai-agent-camp", "path": ".cursor/commands/lesson/start-4-1.es.md", "ref": "66ceb848c302e1f1831ed0f4ecb428fd6df44cfd", "url": "https://github.com/minicoohei/ai-agent-camp/blob/66ceb848c302e1f1831ed0f4ecb428fd6df44cfd/.cursor/commands/lesson/start-4-1.es.md", "key": "minicoohei/ai-agent-camp/.cursor/commands/lesson/start-4-1.es.md" } } }

start-4-1.es

About

🎓 Lesson 4-1: Configuracion de autenticacion de gogcli

📍 Lo que hara en esta sesion

🎯 Verificacion de preparacion

🚀 Step 1: Verificar instalacion de gogcli

🚀 Step 2: Agregar cuenta de Google via OAuth

🚀 Step 3: Prueba de operacion basica

⚠️ Problemas comunes y soluciones

Problema 1: "No se puede instalar gogcli"

Problema 2: "El navegador no se abre"

Problema 3: "No se puede acceder despues de la autenticacion"

Problema 4: "Error de permiso denegado"

✅ Punto de control

📋 Vista previa de resultados

Salida esperada

✅ Verificacion de finalizacion

🎉 Siguientes pasos

Use it

Manifest

Reviews