🦑 Gitset [Astro.js - TypeScript - Node.js - CLI - Open Source]

Gitset é um conjunto de ferramentas open-source para tudo relacionado ao seu código no GitHub — redação de README, pull requests, issues e releases, backups de repositórios e muito mais — disponível tanto como app web quanto como CLI de terminal. Construído sob o modelo BYOAI (bring your own AI key): cada geração vai direto da sua máquina ou da sua sessão do navegador para a sua própria chave da Anthropic, OpenAI, Gemini, OpenRouter, ou qualquer endpoint compatível com OpenAI. O Gitset nunca vê seu código nem sua chave. Licenciado sob MPL-2.0.

---

Funcionalidades Principais:

• README Generator: Redige um README.md completo e estruturado para qualquer repositório a partir do seu conteúdo real, com refinamento interativo antes de escrever qualquer coisa.

• Issue Crafter: Transforma uma descrição informal em uma issue do GitHub estruturada e contextual, pronta para refinar e publicar.

• PR Maker: Gera descrições de pull requests a partir das mensagens de commit e das alterações de arquivos, cobrindo todo o ciclo de vida do PR, da comparação de branches até o merge.

• Release Manager: Redige notas de release a partir do diff real entre duas tags ou branches, com ajustes antes de taguear e publicar.

• Commit Generator: Gera mensagens de commit contextualmente precisas a partir das alterações em stage, adaptando-se ao estilo de commits já existente no projeto.

• Gitignore Builder: Gera um .gitignore sob medida para qualquer combinação de linguagens e frameworks.

• Repo Profiler: Redige uma descrição do repositório e sugestões de topics com base no seu conteúdo real.

• Backup Automator: Configura backups programados do repositório via GitHub Actions, totalmente de propriedade do usuário.

Todas as ferramentas compartilham o mesmo sistema de templates — uma biblioteca curada mais templates salvos pelo usuário — disponível de forma idêntica no app web e na CLI, e cada rascunho passa por uma etapa de refinamento interativo antes de ser escrito ou publicado em qualquer lugar.

A Gitset CLI (@gitset-dev/cli):

A CLI replica todas as ferramentas de redação do app web diretamente no terminal, além de utilitários exclusivamente locais: geração de .gitignore, arquivos de licença, workflows de backup de repositórios, pacotes de labels e resolução de alertas do Dependabot. Ela roda inteiramente na sua máquina — sem conta, sem chamadas a nenhum backend. A configuração e os templates ficam salvos localmente em ~/.gitset.

npm install -g @gitset-dev/cli
gitset config      # configure seu provedor de IA, modelo e tema
gitset commit      # redija uma mensagem de commit a partir das alterações em stage
gitset readme      # redija um README para o repositório atual

Stack Técnico:

• App web: Astro 5 (SSR) com ilhas de React 19, autenticação via GitHub OAuth.
• CLI: Node.js, publicada no npm, compatível com qualquer endpoint de provedor compatível com OpenAI.
• Provedores de IA: Anthropic, OpenAI, Gemini, OpenRouter, ou qualquer endpoint personalizado compatível com OpenAI — fornecido inteiramente pelo usuário.
• Open source: MPL-2.0, repositório público em github.com/gitset-dev/gitset.

Casos de Uso:

• Desenvolvedores que querem conteúdo do GitHub redigido por IA sem perder o controle do resultado final — cada rascunho é refinado de forma interativa antes de ser publicado.
• Times que buscam templates consistentes nos fluxos de README, PR, issues e releases.
• Qualquer pessoa que prefira usar sua própria chave de IA em vez de uma atrelada a um único provedor, e que não queira que seu código passe por um servidor de terceiros.
• Desenvolvedores CLI-first que quer todo o fluxo sem sair do terminal.

Conclusão:

O Gitset representa uma reconstrução completa do produto em torno de uma ideia central: a IA redige o rascunho, o usuário mantém o controle. O projeto demonstra:

• Design de uma arquitetura BYOAI sem custódia de chaves ou código no lado do servidor.
• Construção de experiências equivalentes em web e CLI em torno de um mesmo sistema de templates.
• Publicação e manutenção de um pacote CLI open-source no npm.
• Implementação de GitHub OAuth e automação no nível do repositório (backups baseados em GitHub Actions).
• Abertura de um produto completo sob licença MPL-2.0 com roadmap público.

---