Conecta tu cuenta de GitHub a Goodweek para gestionar repositorios, incidencias, pull requests y flujos de trabajo directamente desde tu espacio de trabajo de IA.
ℹ️ Nota de gobernanza
Goodweek nunca superará los niveles de acceso otorgados al usuario dentro de GitHub, garantizando así el cumplimiento de las políticas de gobernanza de tu organización. Los resultados y las funciones disponibles pueden variar según los permisos específicos y el acceso autenticado de cada usuario.
📋 Requisitos previos
Antes de que cualquier usuario pueda ver y conectar la integración de GitHub, el administrador de tu organización debe habilitarla primero desde el Panel de administración de Goodweek, en la pestaña Integraciones.
Configuración del administrador
La integración de GitHub utiliza OAuth 2.0 y no requiere ninguna aprobación a nivel de administrador para repositorios personales. Sin embargo, acceder a los recursos de una organización de GitHub puede requerir pasos adicionales.
⚠️ Restricciones de aplicaciones OAuth en organizaciones de GitHub
Las organizaciones de GitHub pueden restringir qué aplicaciones OAuth de terceros tienen acceso a los datos de la organización. Si tu organización ha habilitado las restricciones de acceso de aplicaciones OAuth, un propietario de la organización de GitHub debe aprobar Composio antes de que los usuarios puedan acceder a los repositorios y recursos de la organización:
Ve a tu organización de GitHub → Configuración → Acceso de terceros → Política de aplicaciones OAuth.
Busca la aplicación Composio y haz clic en Aprobar para conceder acceso a la organización.
Esta restricción está habilitada de forma predeterminada en las organizaciones de GitHub nuevas. Sin la aprobación, los usuarios pueden conectar su cuenta personal de GitHub, pero no podrán acceder a los repositorios propiedad de la organización.
Conexión del usuario
En Goodweek, ve a Integraciones.
Busca GitHub y haz clic en Conectar.
Serás redirigido a GitHub, donde se te pedirá que inicies sesión y autorices el acceso.
Haz clic en Autorizar para conceder el acceso y volver a Goodweek.
Notas importantes
Cada usuario debe conectar su propia cuenta individualmente.
Goodweek solo puede acceder a los repositorios y recursos que tu cuenta individual de GitHub tenga permiso para ver.
El acceso a los repositorios propiedad de la organización requiere que el propietario de la organización apruebe Composio como se describe anteriormente.
Puedes revocar el acceso de Goodweek en cualquier momento desde GitHub → Configuración → Aplicaciones → Aplicaciones OAuth autorizadas → Composio → Revocar.
Herramientas disponibles
Herramienta | Descripción | Tipo |
Get a Repository | Recupera información detallada sobre un repositorio específico de GitHub. | Lectura |
List Repositories for User | Lista los repositorios de un usuario especificado o del usuario autenticado. | Lectura |
List Organization Repositories | Lista los repositorios de una organización de GitHub especificada. | Lectura |
Search Repositories | Busca repositorios de GitHub utilizando la sintaxis de búsqueda de GitHub. | Lectura |
Create a Repository | Crea un nuevo repositorio de GitHub para el usuario autenticado o la organización. | Escritura |
Get Repository Content | Recupera el contenido de un archivo o directorio en un repositorio. | Lectura |
Create or Update File Contents | Crea un nuevo archivo o actualiza el contenido de un archivo existente en un repositorio. | Escritura |
Get an Issue | Recupera una incidencia específica de GitHub por repositorio y número de incidencia. | Lectura |
List Repository Issues | Lista las incidencias de un repositorio con filtrado opcional por estado, etiquetas y persona asignada. | Lectura |
Create an Issue | Crea una nueva incidencia en un repositorio especificado. | Escritura |
Update an Issue | Actualiza el título, el contenido, el estado, las etiquetas o las personas asignadas de una incidencia existente. | Escritura |
Add Labels to an Issue | Añade una o varias etiquetas a una incidencia de GitHub. | Escritura |
Add Assignees to an Issue | Asigna una o varias personas a una incidencia de GitHub. | Escritura |
Create Issue Comment | Añade un comentario a una incidencia de GitHub existente. | Escritura |
List Issue Comments | Lista todos los comentarios de una incidencia específica de GitHub. | Lectura |
Get a Pull Request | Recupera los detalles de un pull request específico. | Lectura |
List Pull Requests | Lista los pull requests de un repositorio con filtrado opcional por estado y rama. | Lectura |
Create a Pull Request | Crea un nuevo pull request desde una rama de origen a una rama base. | Escritura |
Update a Pull Request | Actualiza el título, el contenido, el estado o la rama base de un pull request. | Escritura |
Create a Review Comment on a Pull Request | Añade un comentario de revisión a una línea específica de un pull request. | Escritura |
Merge a Pull Request | Fusiona un pull request con su rama base. | Escritura |
List Repository Commits | Lista los commits de un repositorio con filtrado opcional por autor, ruta o intervalo de fechas. | Lectura |
Get a Commit | Recupera los detalles de un commit específico mediante su SHA. | Lectura |
List Repository Branches | Lista las ramas de un repositorio especificado. | Lectura |
Create a Branch | Crea una nueva rama en un repositorio a partir de un SHA o rama especificados. | Escritura |
Get a Workflow Run | Recupera los detalles de una ejecución específica de un flujo de trabajo de GitHub Actions. | Lectura |
List Workflow Runs for a Workflow | Lista las ejecuciones de un flujo de trabajo especificado con filtro opcional por estado. | Lectura |
Re-run a Workflow | Vuelve a ejecutar todos los trabajos de una ejecución de flujo de trabajo especificada. | Escritura |
Search Code | Busca código en los repositorios de GitHub utilizando la sintaxis de búsqueda de código de GitHub. | Lectura |
Search Issues and Pull Requests | Busca incidencias y pull requests de GitHub utilizando la sintaxis de búsqueda de GitHub. | Lectura |
Get a User | Recupera información pública de un usuario de GitHub especificado. | Lectura |
Get the Authenticated User | Recupera el perfil del usuario de GitHub autenticado. | Lectura |
List Organization Members | Lista los miembros de una organización de GitHub. | Lectura |
Close an Issue | Cierra una incidencia especificada de GitHub. | ⚠️ Destructivo |
Close a Pull Request | Cierra un pull request especificado sin fusionarlo. | ⚠️ Destructivo |
Delete a File | Elimina un archivo de un repositorio. Esta acción es irreversible sin el historial de control de versiones. | ⚠️ Destructivo |
Casos de uso
Crea y gestiona incidencias desde las conversaciones. Registra nuevas incidencias de GitHub con título, descripción, etiquetas y personas asignadas directamente desde una conversación de Goodweek, útil para capturar errores o solicitudes de funciones sin cambiar a GitHub.
Revisa pull requests e historial de commits. Recupera los detalles de un PR, lista los commits recientes o comprueba el estado de una ejecución de flujo de trabajo desde Goodweek para mantenerte al día de la actividad del repositorio.
Busca código e incidencias en todos los repositorios. Utiliza la sintaxis de búsqueda de GitHub desde Goodweek para encontrar código, incidencias o PRs específicos en tus repositorios sin abrir la interfaz de GitHub.
Crea y actualiza archivos en los repositorios. Lee el contenido de archivos o envía pequeñas actualizaciones de archivos directamente desde Goodweek, útil para actualizar documentación, archivos de configuración o el contenido del README.
Solución de problemas
Conexión correcta, pero faltan los repositorios de la organización
Tu organización de GitHub tiene habilitadas las restricciones de acceso de aplicaciones OAuth. Un propietario de la organización de GitHub debe aprobar Composio desde Configuración de la organización → Acceso de terceros → Política de aplicaciones OAuth.
Integración no visible en Goodweek
Asegúrate de que el administrador de tu organización haya habilitado la integración de GitHub desde el Panel de administración de Goodweek, en la pestaña Integraciones.