Overview
Public docs
Move tags, releases, notes, and assets across Git forges without redoing work.
gfrm is a resilient cross-forge CLI for GitHub, GitLab, and Bitbucket Cloud. It migrates tags first,
then releases, keeps checkpoint state on disk, and resumes interrupted runs with gfrm resume.
Download compiled binaries
Use the release artifacts on clean machines. No Dart, Node, FVM, or Yarn is required on the target host.
Persist state safely
Every run writes logs, summary, and failed tags under a timestamped work directory.
Resume instead of restarting
Completed work is skipped. Incomplete or failed items are retried from saved session state.
Start here
Quick Start
Get the right artifact, configure tokens once, and run a first migration.
Settings Profiles
Use persistent provider profiles instead of passing tokens on every run.
Support Matrix
Check supported cross-forge pairs, provider aliases, and explicit non-goals.
Operating model
- Tags are migrated before releases.
- Release selection currently targets semver tags in the form
vX.Y.Z. - Each run writes under
./migration-results/<timestamp>/. summary.jsonuses schema version2and includes the executed command metadata.- When failures exist,
summary.jsonincludes a retry command that usesgfrm resume.
Release artifacts
Download binaries and checksums from GitHub Releases.
| Asset | Platform |
|---|---|
gfrm-macos-intel.zip | macOS Intel |
gfrm-macos-silicon.zip | macOS Apple Silicon |
gfrm-linux.zip | Linux |
gfrm-windows.zip | Windows |
checksums-sha256.txt | SHA256 checksums for all zip assets |