smokey

Smokey é um dashboard de desenvolvedor estático, de arquivo único, para monitorar a saúde de repositórios do GitHub. Você abre o index.html em um navegador, insere um nome de usuário ou organização do GitHub, lista os repositórios no formato owner/repo, e a página renderiza o estado atual deles em uma única tabela classificável. O objetivo declarado é visualizar a saúde do repositório sem precisar navegar clicando pelo GitHub. O que a tabela mostra - Último push por repositório, com o push mais antigo listado primeiro por padrão; qualquer cabeçalho de coluna (repositório, último push, PRs, issues) pode ser clicado para reclassificar. - Versão do lançamento mais recente e data de lançamento, exibidos sob o nome do repositório. - Contagens de pull requests abertos e issues abertos; clicar em uma contagem abre a página do GitHub filtrada para aquele repositório. - Badges de atenção: uma linha para PRs abertos e uma para issues abertos, aparecendo apenas para repositórios com atividade de contribuidores externos, com cada badge linkando para a visualização filtrada do GitHub. PRs criados por bots (por exemplo, do github-actions[bot]) são filtrados automaticamente. Autenticação Repositórios públicos carregam sem login. Um token de acesso pessoal do GitHub pode ser opcionalmente adicionado no painel de configurações para desbloquear repositórios privados e a coluna de status de CI, e é necessário para repositórios de organizações protegidos por SAML SSO se o token estiver autorizado para aquela organização. Como o acesso à API não autenticado é limitado a 60 requisições por hora e cada repositório consome quatro requisições, um token torna-se necessário quando aproximadamente quinze repositórios públicos são monitorados; um token autenticado eleva o limite para 5.000 requisições por hora. O README afirma que o token é armazenado apenas no localStorage do navegador e enviado apenas para api.github.com. Tanto tokens clássicos (escopo repo) quanto tokens fine-grained (Contents: Read, Metadata: Read, Actions: Read para status de CI) são descritos. Gráfico de tráfego Em vez da API de tráfego ao vivo do GitHub, o dashboard desenha um gráfico de área de tráfego de histórico completo usando um snapshot diário mantido em um branch traffic-log, acumulado por um workflow separado do GitHub Actions semanal (log-traffic.yml). O gráfico usa um eixo de tempo logarítmico que expande os dias recentes e uma escala de valor de raiz quadrada. Esta visualização não requer token. Se o branch ou as linhas registradas ainda não existirem, o gráfico reporta que não há histórico de tráfego. Hospedagem e configuração Não há etapa de build, instalação de dependências nem servidor. Uma cópia hospedada está disponível no GitHub Pages, portanto, o dashboard pode ser usado sem instalar nada; caso contrário, você baixa o index.html e o abre localmente. Para executar sua própria instância, faça um fork do repositório e ative o GitHub Pages a partir da pasta raiz do branch principal. O layout é descrito como mobile-friendly e compacto, sem barras laterais. O README também documenta casos de solução de problemas: uma página em cache obsoleta produzindo uma mensagem persistente de "add a PAT" (resolvida por um hard refresh, observando que o localStorage é limpo em janelas privadas), erros 403 causados por limites de taxa não autenticados ou falta de autorização SAML, e o gráfico de tráfego permanecendo vazio até que o workflow de registro tenha sido executado pelo menos uma vez após a adição dos repositórios. Licença e contato: Licença MIT, copyright 2025 Scott Kirvan. Contribuições são convidadas através de issues, forks e pull requests; os canais de contato listados incluem LinkedIn e um servidor Discord, e o repositório inclui um CHANGELOG e TODO em sua pasta notes.