> ## 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

> Conecte o GitHub à Tess para trabalhar com repositórios, pull requests e issues no chat e nos agentes.

O conector do **GitHub** integra a Tess ao GitHub para colaboração em código. Depois de conectado, a IA pode inspecionar repositórios, resumir pull requests e issues, e apoiar fluxos de engenharia dentro de chats e agentes.

O conector **GitHub** faz parte do ecossistema de [Connectors](/pt/connectors) da Tess e usa autenticação **OAuth** para conectores de Apps.

## Pré-requisitos

<Info>
  * Conta no GitHub com acesso aos repositórios que você quer usar.
  * Permissão para autorizar o app OAuth do GitHub nesses repos/orgs.
</Info>

## Como conectar

<Tip>
  Em alguns conectores de Apps, a tela de consentimento OAuth pode exibir o nome de uma ponte de conexão de terceiros em vez da Tess. Isso é normal—revise as permissões solicitadas e continue se fizerem sentido para o uso.
</Tip>

<Steps>
  <Step title="Abra o painel de Conectores">
    No chat, clique no **+** ao lado da caixa de mensagem e selecione **Connectors**.
    Você também pode gerenciar conectores na edição do agente no Agent Studio.

    <Frame>
      <img src="https://mintlify.s3.us-west-1.amazonaws.com/tess-dfe1edf0/images/connectors/github/01-connect-panel.png" alt="PRINT: (Painel de Conectores com GitHub em destaque e o botão Connect visível)" />
    </Frame>
  </Step>

  <Step title="Localize GitHub e clique em Connect">
    Em **Apps**, encontre **GitHub** e clique em **Connect** para iniciar a autenticação.

    <Frame>
      <img src="https://mintlify.s3.us-west-1.amazonaws.com/tess-dfe1edf0/images/connectors/github/02-oauth-consent.png" alt="PRINT: (Tela de autorização / consentimento do provedor para GitHub)" />
    </Frame>
  </Step>

  <Step title="Autorize o acesso">
    Faça login na conta desejada e revise as permissões solicitadas antes de confirmar.
  </Step>

  <Step title="Confirme que está ativo">
    Ao voltar para a Tess, **GitHub** deve aparecer em **Connected**, pronto para chats e agentes.

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

## O que você pode fazer

* **Listar e inspecionar repositórios**, branches e atividade recente
* **Revisar pull requests** — resumir mudanças, comentários e status
* **Trabalhar com issues** — buscar, criar, atualizar e fazer triagem
* **Apoiar contexto de release e CI** quando a conta puder ver checks e workflows
* **Ajudar times de produto e engenharia** a manter contexto técnico em um só lugar

## Exemplos de prompt

> 1. Liste as pull requests mais recentes do projeto e resuma o propósito de cada uma.
> 2. Encontre issues relacionadas à integração de conectores e organize por prioridade.
> 3. Resuma o que mudou nas PRs abertas mais recentes e destaque riscos.
> 4. Crie uma issue com o título 'Lacuna de docs em Connectors', uma descrição curta e label documentation.

## Boas práticas

* Informe owner/repo quando você tiver acesso a muitos repositórios.
* Peça um resumo antes de ações que alterem código.
* Em agentes, deixe claro se o GitHub é para status, triagem ou rascunho de mudanças.

## Troubleshooting

<AccordionGroup>
  <Accordion icon="circle-question" title="OAuth negado ou repos ausentes">
    Reautorize com uma conta que acesse a organização/repos e aprove o acesso da org se o GitHub pedir.
  </Accordion>

  <Accordion icon="circle-question" title="401 / conexão caiu">
    Reconecte o GitHub em Conectores após mudança de senha, SSO ou revogação de token.
  </Accordion>

  <Accordion icon="circle-question" title="Repo privado não encontrado">
    Confirme que a conta conectada tem permissão nesse repositório.
  </Accordion>
</AccordionGroup>

<Note>
  A Tess age com as permissões da conta conectada. Ela não amplia acessos além do que essa conta já pode fazer.

  Conectores envolvem acesso a sistemas externos. Conecte apenas contas adequadas ao uso e revise as permissões com cuidado.
</Note>