> ## Documentation Index
> Fetch the complete documentation index at: https://docs.leme.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# GitHub

> Permite que los agents exploren repositorios, issues y pull requests — y creen trabajo donde lo permitas

Conecta GitHub y tus agents podrán responder preguntas sobre el trabajo en tu código sin que nadie salga de la conversación: qué está abierto, qué está atascado, qué se lanzó. También pueden crear issues y dejar comentarios — con una persona aprobando primero, por defecto.

## Qué pueden hacer los agents

| Capacidad                            | Detalles                                               |
| ------------------------------------ | ------------------------------------------------------ |
| Listar organizaciones y repositorios | Todo lo visible para la cuenta conectada.              |
| Leer detalles de un repositorio      | Rama por defecto, visibilidad, lenguaje, enlaces.      |
| Listar ramas                         | Nombres de ramas y últimos commits.                    |
| Listar y leer issues                 | Con filtros; detalle completo por número.              |
| Listar y leer pull requests          | Estado, ramas, autor, conteo de reviews y comentarios. |
| Crear issues                         | Abrir un issue nuevo en un repositorio.                |
| Comentar en issues y PRs             | Visible para todos en el repositorio.                  |

La lectura corre libremente por defecto. Crear issues pide aprobación por defecto, y los comentarios — colaboración visible — también. Consulta [Permisos](#permisos).

## Prueba preguntar

* *"¿Qué pull requests están abiertos en acme/webapp y quién está esperando review?"*
* *"Resume la discusión del issue #482."*
* *"¿Qué issues se cerraron en acme/api esta semana?"*
* *"Crea un issue en acme/webapp: el botón de exportar da error 500 en workspaces grandes. Incluye lo que encontramos en esta conversación."* — se crea después de la aprobación.
* *"Comenta en el PR #91 pidiendo una entrada en el changelog."* — se publica después de la aprobación.

## Conectar GitHub

<Steps>
  <Step title="Abre Integraciones">
    En el dashboard de Leme, ve a **Integraciones** y selecciona **GitHub**.
  </Step>

  <Step title="Autoriza en GitHub">
    Selecciona **Conectar** y aprueba en la pantalla de consentimiento de GitHub con la cuenta cuyo acceso deban tener los agents.
  </Step>

  <Step title="Habilítalo en tus agents">
    Vincula la conexión a los agents que deban usarla y revisa los **Agent permissions**.
  </Step>
</Steps>

GitHub es una conexión **compartida**: los agents ven exactamente lo que la cuenta conectada puede ver. Conecta con una cuenta cuyo acceso a repositorios coincida con lo que quieres que los agents alcancen — muchos equipos usan una cuenta de máquina dedicada para esto.

<Note>
  Si tu organización restringe las apps OAuth, es posible que un owner de la organización deba aprobar Leme antes de que los repositorios de la organización sean visibles. Es una configuración del lado de GitHub: **Organization settings → Third-party access**.
</Note>

## Permisos

| Acción                                         | Categoría            | Por defecto  |
| ---------------------------------------------- | -------------------- | ------------ |
| Listar y leer repositorios, ramas, issues, PRs | Lectura              | Allow        |
| Crear issues                                   | Escritura            | Ask approval |
| Comentar en issues y PRs                       | Comunicación externa | Ask approval |

Ajusta en **Integraciones → GitHub → Agent permissions** — consulta [Permisos y aprobaciones](/es/permissions). Si crear issues se vuelve rutinario, puedes permitir solo esa acción y mantener los comentarios detrás de aprobación.

## Solución de problemas

<AccordionGroup>
  <Accordion title="El agent no encuentra un repositorio que existe">
    La cuenta conectada no puede verlo. Revisa el acceso de la cuenta a ese repositorio — y para repositorios de organización, verifica que tu organización haya aprobado la app de Leme bajo las restricciones de acceso de terceros.
  </Accordion>

  <Accordion title="Faltan los repositorios de la organización, los personales funcionan">
    Casi siempre es la restricción de apps OAuth de la organización. Un owner de la organización debe aprobar el acceso para Leme en GitHub.
  </Accordion>

  <Accordion title="La conexión dejó de funcionar después de un tiempo">
    La autorización expiró o se revocó en GitHub (por ejemplo, el usuario que conectó revocó la app o salió de la organización). Reconecta desde **Integraciones → GitHub**.
  </Accordion>

  <Accordion title="Un conteo de issues se ve raro">
    La API de GitHub cuenta los pull requests como issues en algunos listados. A los agents se les indica distinguir los dos, pero si un número parece sospechoso, pídele al agent que liste los elementos en lugar del conteo.
  </Accordion>
</AccordionGroup>