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

# GitHub

> Conecta GitHub a Tess para trabajar con repositorios, pull requests e issues desde el chat y los agentes.

El conector de **GitHub** integra Tess con GitHub para colaboración en código. Una vez conectado, la IA puede inspeccionar repositorios, resumir pull requests e issues y apoyar flujos de ingeniería dentro de chats y agentes.

El conector **GitHub** forma parte del ecosistema de [Connectors](/es/connectors) de Tess y usa autenticación **OAuth** para conectores de Apps.

## Prerrequisitos

<Info>
  * Una cuenta de GitHub con acceso a los repositorios que quieres usar.
  * Permiso para autorizar la app OAuth de GitHub en esos repos/orgs.
</Info>

## Cómo conectar

<Tip>
  En algunos conectores de Apps, la pantalla de consentimiento OAuth puede mostrar el nombre de un puente de conexión de terceros en lugar de Tess. Es normal: revisa los permisos solicitados y continúa si coinciden con lo que esperas.
</Tip>

<Steps>
  <Step title="Abre el panel de Connectors">
    En el chat, haz clic en el **+** junto al cuadro de mensaje y selecciona **Connectors**.
    También puedes gestionar conectores al editar un agente en Agent Studio.

    <Frame>
      <img src="https://mintlify.s3.us-west-1.amazonaws.com/tess-dfe1edf0/images/connectors/github/01-connect-panel.png" alt="PRINT: (Panel de Connectors con GitHub destacado y el botón Connect visible)" />
    </Frame>
  </Step>

  <Step title="Localiza GitHub y haz clic en Connect">
    En **Apps**, encuentra **GitHub** y haz clic en **Connect** para iniciar la autenticación.

    <Frame>
      <img src="https://mintlify.s3.us-west-1.amazonaws.com/tess-dfe1edf0/images/connectors/github/02-oauth-consent.png" alt="PRINT: (Pantalla de autorización / consentimiento del proveedor para GitHub)" />
    </Frame>
  </Step>

  <Step title="Autoriza el acceso">
    Inicia sesión con la cuenta que quieras usar y revisa los permisos solicitados antes de confirmar.
  </Step>

  <Step title="Confirma que está activo">
    Al volver a Tess, **GitHub** debería aparecer en **Connected**, listo para chats y agentes.

    <Frame>
      <img src="https://mintlify.s3.us-west-1.amazonaws.com/tess-dfe1edf0/images/connectors/github/03-connected.png" alt="PRINT: (Callback de Tess o lista de Connectors mostrando GitHub como Connected con estado de éxito)" />
    </Frame>
  </Step>
</Steps>

## Qué puedes hacer

* **Listar e inspeccionar repositorios**, ramas y actividad reciente
* **Revisar pull requests** — resumir cambios, comentarios y estado
* **Trabajar con issues** — buscar, crear, actualizar y hacer triage
* **Apoyar contexto de release y CI** cuando la cuenta pueda ver checks y workflows
* **Ayudar a equipos de producto e ingeniería** a mantener el contexto técnico en un solo lugar

## Ejemplos de prompt

> 1. Lista las pull requests más recientes del proyecto y resume el propósito de cada una.
> 2. Encuentra issues relacionadas con la integración de conectores y organízalas por prioridad.
> 3. Resume qué cambió en las PRs abiertas más recientes y señala riesgos.
> 4. Crea un issue titulado 'Brecha de docs en Connectors' con una descripción breve y la label documentation.

## Buenas prácticas

* Indica owner/repo cuando tengas acceso a muchos repositorios.
* Pide un resumen antes de acciones que cambien código.
* En agentes, aclara si GitHub es para estado, triage o borradores de cambios.

## Troubleshooting

<AccordionGroup>
  <Accordion icon="circle-question" title="OAuth denegado o repos ausentes">
    Reautoriza con una cuenta que acceda a la organización/repos y aprueba el acceso de la org si GitHub lo pide.
  </Accordion>

  <Accordion icon="circle-question" title="401 / conexión caída">
    Vuelve a conectar GitHub en Connectors tras cambios de contraseña, SSO o revocación de token.
  </Accordion>

  <Accordion icon="circle-question" title="Repo privado no encontrado">
    Confirma que la cuenta conectada tiene permiso en ese repositorio.
  </Accordion>
</AccordionGroup>

<Note>
  Tess usa los permisos de la cuenta conectada. No amplía el acceso más allá de lo que esa cuenta ya puede hacer.

  Los conectores implican acceso a sistemas externos. Conecta solo cuentas adecuadas al contexto de uso y revisa los permisos con cuidado.
</Note>