Com o GitHub conectado, você pede no chat para explorar a estrutura de um projeto, ler README, documentação e código, buscar onde uma função ou configuração aparece e consultar issues e pull requests. A conexão é só de leitura, e cada pergunta vai ao GitHub na hora: nada é copiado para a base de conhecimento.
O que a Lumina faz#
| Pode | Não pode |
|---|---|
| listar os repositórios que você pode ler | comentar, abrir issue ou pull request, ou fazer commit |
| listar pastas e ler arquivos de texto | ler arquivos binários ou acima de 1 MB |
| buscar código num repositório ou numa organização | importar um repositório para um projeto ou indexá-lo |
| listar e abrir issues e pull requests, com comentários e trechos do diff | ver repositórios que você não vê no github.com |
Colar um link do GitHub (de arquivo, issue ou pull request) leva a Lumina direto ao item.
Antes de conectar#
- Você precisa de uma conta no GitHub com acesso aos repositórios que quer usar.
- Além de conectar, o app da Lumina precisa estar instalado na conta ou organização dona dos repositórios. Em repositórios de uma organização, quem instala é o owner da organização.
Como conectar#
- Na barra lateral, abra Conexões.
- No card do GitHub, clique em Conectar e autorize o app da Lumina na tela do GitHub.
- Repositórios pessoais: instale o app na sua conta pelo link que a Lumina mostra, com todos os repositórios ou só alguns.
- Repositórios de uma organização: o owner instala o app na organização uma vez. Se você não é owner, o mesmo link mostra a opção de pedir a instalação, e o GitHub encaminha o pedido ao owner. Depois de aprovado, o acesso aparece sem você reconectar.
O que pedir no chat#
- "Liste os repositórios a que tenho acesso pela Lumina."
- "Explique a estrutura de pastas do repositório minhaorg/api."
- "Onde a variável de timeout é configurada em minhaorg/api?"
- "Resuma este pull request e os comentários: https://github.com/…/pull/…"
- "Quais issues abertas em minhaorg/app falam de login?"
Limitações#
- Arquivos acima de 1 MB e arquivos binários não são lidos. Arquivos de texto grandes são lidos em partes.
- A busca de código do GitHub só cobre o branch padrão e arquivos abaixo de 384 KB, e aceita até 10 buscas por minuto por pessoa.
- Repositórios não podem ser importados como fonte de conhecimento de um projeto.
Problemas comuns#
| O que aparece | Causa provável | O que fazer |
|---|---|---|
| O repositório não aparece | nome errado, repositório privado fora do seu acesso, ou app não instalado no dono | confira o nome; peça a instalação ao owner pelo link que a Lumina mostra |
| Acesso recusado em um repositório | a organização liberou só alguns repositórios ao app | o owner adiciona o repositório à instalação do app; reconectar não resolve |
| Pedido de autorização SSO | a organização exige SAML SSO | autorize a sessão SSO no link que a Lumina mostra |
| Limite de requisições do GitHub | muitas chamadas em pouco tempo | espere alguns minutos; reconectar não resolve |
| "Sua conexão expirou. Reconecte a conta." | a autorização foi revogada no GitHub | clique em Reconectar no card |
Para o administrador ou TI#
A Lumina usa um GitHub App com permissões de repositório somente leitura:
- Contents — ler arquivos e pastas;
- Issues — ler issues e comentários;
- Pull requests — ler pull requests, arquivos alterados e comentários;
- Metadata — obrigatória em todo GitHub App.
Não há permissão de escrita, de organização ou de conta. O owner escolhe, na instalação, se libera todos os repositórios ou só alguns, e pode mudar isso depois nas configurações do app na organização.
Cada pessoa usa o próprio acesso. A Lumina enxerga um repositório só quando a pessoa tem acesso a ele no GitHub e o app está instalado no dono dele. Num projeto ou agente compartilhado, cada pessoa que pergunta vê só o que ela mesma tem. Organizações com SAML SSO exigem que cada pessoa autorize a sessão SSO; a Lumina mostra o link quando isso falta.
Privacidade e desconexão#
A conexão é sua e vale só na organização em que foi feita. Como nada é salvo, ninguém lê um repositório pela sua conexão.
Para desconectar, abra Conexões, clique em … no card e em Desconectar. Isso revoga o acesso daquela conexão. A autorização continua listada nas configurações do GitHub (aplicações autorizadas) até você removê-la lá.