> For the complete documentation index, see [llms.txt](https://docs.crew.you/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.crew.you/es/service-connections/github.md).

# GitHub

Conecta tu cuenta de GitHub para gestionar repositorios, issues, pull requests e incluso hacer cambios de código — todo a través de la conversación.

> **Requisito de plan:** La integración con GitHub está disponible en el plan **Pro**.

## Conectar GitHub

Crew usa una **GitHub App** llamada **Crew Agent** para un acceso seguro y detallado a tus repositorios.

1. Ve a **Configuración** en la barra lateral
2. Desplázate hasta **Conexiones de servicios**
3. Haz clic en **Conectar** junto a GitHub
4. Serás redirigido a GitHub para instalar la app **Crew Agent**
5. Elige a qué repositorios conceder acceso (todos o solo algunos)
6. Autoriza la app — volverás a Crew automáticamente

Una vez conectado, tu nombre de usuario de GitHub aparecerá en la página de Configuración.

### ¿Por qué una GitHub App?

La GitHub App Crew Agent ofrece:

* **Permisos detallados** — Solo accede a los repositorios que tú elijas
* **Agente de código seguro** — El Coding Agent puede clonar repos y crear PRs sin necesitar tu token personal
* **Renovación automática de tokens** — No hace falta reconectar cuando los tokens expiran

### Reconectar

Si necesitas cambiar a qué repositorios tiene acceso Crew, desconecta y vuelve a conectar GitHub desde la página de Configuración. Podrás actualizar tu selección de repositorios durante la reinstalación.

## Qué puedes hacer

### Gestión de repositorios

> "Lista mis repositorios de GitHub."

> "Muéstrame los issues abiertos en mi-org/mi-repo."

> "¿Cuáles son los pull requests más recientes en el repo de frontend?"

### Issues

> "Crea un issue en mi-org/api-server titulado 'Corregir timeout de login' con una descripción del bug."

> "Lista todos los issues asignados a mí en mis repositorios."

> "Cierra el issue #42 en el repo de backend."

### Pull Requests

> "Muéstrame los PRs abiertos en el repo de design-system."

> "¿Cuál es el estado del PR #15?"

> "Crea un comentario de revisión en el PR."

### Coding Agent

El **Coding Agent** es una funcionalidad poderosa que puede hacer cambios reales de código en tu repositorio:

> "En mi-org/frontend-app, corrige el problema de alineación CSS en la página de login. El botón de enviar debería estar centrado."

> "Refactoriza el módulo de autenticación en mi-org/api-server para usar tokens JWT en lugar de cookies de sesión."

Cuando usas el Coding Agent:

1. Crew clona el repositorio en un entorno seguro
2. Realiza los cambios solicitados de forma autónoma
3. Hace commit de los cambios en una nueva rama
4. Crea un pull request para tu revisión

Esto se ejecuta en segundo plano — puedes seguir chateando mientras trabaja. Crew te avisará cuando el PR esté listo.

## Escenarios prácticos

### Triaje de bugs

> "Muéstrame todos los bugs abiertos en el repo principal, ordenados por más recientes, y resume los 5 principales."

### Preparación de code review

> "Lista los PRs abiertos que necesitan mi revisión y resume qué cambia cada uno."

### Correcciones rápidas

> "El README en mi-org/docs tiene un error tipográfico — cambia 'recieve' a 'receive' y crea un PR."

## Notas importantes

* El Coding Agent crea ramas y PRs — nunca hace push directamente a main
* Tú siempre revisas y haces merge de los cambios
* El acceso al repositorio está controlado por la instalación de tu GitHub App — Crew solo puede acceder a los repos que hayas permitido explícitamente
