Visão Geral
Documentação pública
Migre tags, releases, notas e artefatos entre Git forges sem refazer trabalho.
gfrm é uma CLI cross-forge resiliente para GitHub, GitLab e Bitbucket Cloud. Ela migra tags primeiro,
depois releases, mantém checkpoints em disco e retoma execuções interrompidas com gfrm resume.
Baixe binários compilados
Use os artefatos de release em máquinas limpas. O host de destino não precisa de Dart, Node, FVM ou Yarn.
Persista estado com segurança
Cada execução grava logs, sumário e tags com falha em um diretório versionado por timestamp.
Retome em vez de reiniciar
Itens concluídos são ignorados. Itens incompletos ou com falha são retomados a partir da sessão salva.
Comece por aqui
Quick Start
Escolha o artefato correto, configure tokens uma vez e execute a primeira migração.
Perfis de Settings
Use perfis persistentes de provider em vez de passar tokens em cada comando.
Matriz de Suporte
Consulte pares cross-forge suportados, aliases de provider e os não-objetivos explícitos.
Modelo operacional
- Tags são migradas antes de releases.
- A seleção de releases atualmente mira tags semver no formato
vX.Y.Z. - Cada execução grava em
./migration-results/<timestamp>/. summary.jsonusa schema version2e inclui metadados do comando executado.- Quando existem falhas,
summary.jsoninclui um retry command comgfrm resume.
Artefatos de release
Baixe binários e checksums em GitHub Releases.
| Artefato | Plataforma |
|---|---|
gfrm-macos-intel.zip | macOS Intel |
gfrm-macos-silicon.zip | macOS Apple Silicon |
gfrm-linux.zip | Linux |
gfrm-windows.zip | Windows |
checksums-sha256.txt | Checksums SHA256 de todos os zips |