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

> Deixe agents navegarem por repositórios, issues e pull requests — e registrarem trabalho onde você permitir

Conecte o GitHub e seus agents respondem perguntas sobre o trabalho no código sem ninguém sair da conversa: o que está aberto, o que está travado, o que foi entregue. Eles também podem abrir issues e deixar comentários — com um humano aprovando antes, por padrão.

## O que os agents podem fazer

| Capacidade                         | Detalhes                                                       |
| ---------------------------------- | -------------------------------------------------------------- |
| Listar organizações e repositórios | Tudo o que está visível para a conta conectada.                |
| Ler detalhes de repositórios       | Branch padrão, visibilidade, linguagem, links.                 |
| Listar branches                    | Nomes de branches e commits mais recentes.                     |
| Listar e ler issues                | Com filtros; detalhe completo pelo número da issue.            |
| Listar e ler pull requests         | Estado, branches, autoria, contagens de reviews e comentários. |
| Criar issues                       | Abrir uma issue nova em um repositório.                        |
| Comentar em issues e PRs           | Visível para todos no repositório.                             |

A leitura roda livremente por padrão. Criar issues pede aprovação por padrão, e comentários — colaboração visível — também. Veja [Permissões](#permissões).

## Experimente perguntar

* *"Quais pull requests estão abertos em acme/webapp e quem está esperando review?"*
* *"Resuma a discussão da issue #482."*
* *"Quais issues foram fechadas em acme/api nesta semana?"*
* *"Abra uma issue em acme/webapp: o botão de exportar retorna 500 para workspaces grandes. Inclua o que descobrimos nesta conversa."* — criada após aprovação.
* *"Comente no PR #91 pedindo uma entrada no changelog."* — publicado após aprovação.

## Conectar o GitHub

<Steps>
  <Step title="Abra Integrações">
    No dashboard da Leme, acesse **Integrações** e selecione **GitHub**.
  </Step>

  <Step title="Autorize no GitHub">
    Selecione **Conectar** e aprove na tela de consentimento do GitHub com a conta cujo acesso os agents devem ter.
  </Step>

  <Step title="Habilite nos seus agents">
    Vincule a conexão aos agents que devem usá-la e revise as **Permissões de agent**.
  </Step>
</Steps>

O GitHub é uma conexão **compartilhada**: os agents veem exatamente o que a conta conectada vê. Conecte com uma conta cujo acesso a repositórios corresponda ao que você quer que os agents alcancem — muitos times usam uma machine account dedicada para isso.

<Note>
  Se a sua organização restringe apps OAuth, um owner da organização pode precisar aprovar a Leme antes que os repositórios da organização fiquem visíveis. Essa configuração fica do lado do GitHub: **Organization settings → Third-party access**.
</Note>

## Permissões

| Ação                                             | Categoria           | Padrão          |
| ------------------------------------------------ | ------------------- | --------------- |
| Listar e ler repositórios, branches, issues, PRs | Leitura             | Permitir        |
| Criar issues                                     | Escrita             | Pedir aprovação |
| Comentar em issues e PRs                         | Comunicação externa | Pedir aprovação |

Ajuste em **Integrações → GitHub → Permissões de agent** — veja [Permissões e aprovações](/pt-BR/permissions). Se abrir issues virar rotina, você pode permitir só essa ação e manter os comentários atrás de aprovação.

## Solução de problemas

<AccordionGroup>
  <Accordion title="O agent não encontra um repositório que existe">
    A conta conectada não consegue vê-lo. Verifique o acesso da conta àquele repositório — e, para repositórios de organização, verifique se a organização aprovou o app da Leme nas restrições de acesso de terceiros.
  </Accordion>

  <Accordion title="Repositórios da organização não aparecem, os pessoais funcionam">
    Quase sempre é a restrição de apps OAuth da organização. Um owner da organização precisa aprovar o acesso da Leme no GitHub.
  </Accordion>

  <Accordion title="A conexão parou de funcionar depois de um tempo">
    A autorização expirou ou foi revogada no GitHub (por exemplo, o usuário que conectou revogou o app ou saiu da organização). Reconecte em **Integrações → GitHub**.
  </Accordion>

  <Accordion title="Uma contagem de issues parece errada">
    A API do GitHub conta pull requests como issues em algumas listagens. Os agents são instruídos a distinguir os dois, mas se um número parecer suspeito, peça ao agent para listar os itens em vez da contagem.
  </Accordion>
</AccordionGroup>