█▀▀ █▀█ █▀▄▀█ █▀▄▀█ █ ▀█▀ █▀▀ █▀█ █▀█ █▀▀ █▀▀ █▄▄ █▄█ █ ▀ █ █ ▀ █ █ █ █▀ █▄█ █▀▄ █▄█ ██▄
Commite no passado, direto do seu terminal.
Crie commits com datas retroativas no GitHub, GitLab ou Bitbucket. Controle total do histórico git a partir da linha de comando.
Instalar CommitForge
Escolha o método ideal para o seu ambiente
curl -fsSL https://raw.githubusercontent.com/estevam5s/commitforge/main/cli-commit/install.sh | bash
Instala automaticamente em macOS e Linux. Requer Python 3.8+ e git.
Dois modos de commit
Escolha a estratégia ideal para o seu caso de uso
Modo Projeto
--modo projetoCommita arquivos reais agrupados semanticamente. 17 grupos automáticos: configuração, estilos, componentes, backend, CLI, templates, docs.
commitforge commit --repo URL --year 2019 --modo projeto- Arquivos reais
- 17 grupos semânticos
- Branch órfão limpo
- Histórico natural
Modo Arquivo
--modo arquivoCria commits modificando um arquivo de log. Ideal para preencher gráfico de contribuições com quantidade exata de commits.
commitforge commit --repo URL --year 2020 --modo arquivo --commits-por-dia 3- Controle exato
- N commits/dia
- Pular fins de semana
- Mensagem customizada
Referência da CLI
Todos os comandos e flags disponíveis
Comandos CLI
Flags principais
| Flag | Tipo | Padrão | Descrição |
|---|---|---|---|
--repo, -r | string | — | URL do repositório Git |
--year, -y | int | — | Ano completo (ex: 2019) |
--start-date | date | — | Data início YYYY-MM-DD |
--end-date | date | — | Data fim YYYY-MM-DD |
--dias, -d | int | 30 | Últimos N dias |
--modo, -M | choice | projeto | projeto ou arquivo |
--branch | string | historico-{year} | Nome do branch |
--token, -t | string | $GITHUB_TOKEN | Token de acesso |
--commits-por-dia | int | 1 | Commits por dia (modo arquivo) |
--aleatorio | flag | false | Horários aleatórios |
--pular-fins-de-semana | flag | false | Pular sábado/domingo |
--sem-push | flag | false | Não enviar ao remoto |
--interativo | flag | false | Modo interativo |
Como funciona
Cinco etapas para reescrever seu histórico git
Clone o repositório em diretório temporário
CommitForge clona o repo em /tmp para análise sem alterar seu ambiente local.
Agrupa arquivos em 17 categorias semânticas
Os arquivos são classificados por tipo: configuração, estilos, componentes, backend, CLI, templates, docs e mais.
Distribui datas uniformemente no período
As datas dos commits são distribuídas de forma natural ao longo do ano ou intervalo definido.
Cria commits com datas retroativas
Cada commit é criado com GIT_AUTHOR_DATE e GIT_COMMITTER_DATE configurados para o passado, com e-mail verificado da conta GitHub.
Push com force para o remoto via token
git push --force envia o histórico reescrito diretamente para o repositório remoto autenticado.
Commits aparecem no gráfico de contribuições
Os commits ficam visíveis na atividade do perfil GitHub. Selecione o ano no gráfico para ver os commits retroativos.
Plataformas suportadas
Compatível com qualquer serviço Git via HTTPS ou SSH
Estevam Souza
O que você acha?
Sua opinião ajuda a melhorar o CommitForge