Skip to main content

First Migration

This is the shortest useful migration path.

Configure tokens once​

./gfrm setup

Use Settings Profiles if you need more than one environment.

Run a real migration​

./gfrm migrate \
  --source-provider gitlab \
  --source-url "https://gitlab.com/group/project" \
  --target-provider github \
  --target-url "https://github.com/org/repo"

Validate without writing to the target​

./gfrm migrate \
  --source-provider gitlab \
  --source-url "https://gitlab.com/group/project" \
  --target-provider github \
  --target-url "https://github.com/org/repo" \
  --dry-run

Inspect artifacts​

Every run writes under:

./migration-results/<YYYYMMDD-HHMMSS>/

Expected artifacts:

  • migration-log.jsonl
  • summary.json
  • failed-tags.txt

If failures exist, summary.json includes a retry_command that uses gfrm resume.