migtea 0.2.0

Batch-migrate repositories between GitHub and Gitea from a Textual TUI

migtea

Batch-migrate repositories between GitHub and Gitea from a terminal UI. migtea (migrate to Gitea) is a Textual TUI that drives the official gh and tea CLIs: it preflights both tools, diffs your GitHub account against a Gitea instance, lets you tick the repositories that are missing, totals their sizes, and migrates each one (wiki, LFS, issues, and more) with per-repo and overall progress.

Website: botmonster.com/migtea

Run it with no install:

uvx migtea

Why

Gitea's web "New Migration" page moves exactly one repository per submission. The engine behind it has no such limit, and neither does the tea CLI's tea repos migrate. migtea orchestrates that CLI across every repository you select, so moving a whole account is one pass instead of one form per repo.

Requirements

migtea does not bundle or install these; it uses whatever is already on your PATH, installed the official way:

• GitHub CLI (gh), logged in (gh auth login).
• Gitea CLI (tea), with at least one login configured (tea login add).
• uv to run uvx migtea (or pip install migtea).
• git is additionally required for the reverse (Gitea to GitHub) direction.

If a tool or login is missing, migtea's preflight screen prints the exact official command to fix it and waits for you to re-check. It never pipes a script into your shell and never installs anything itself.

Screens

1. Preflight. migtea checks that gh and tea are installed and logged in before anything else. If a check fails it prints the exact official command to fix it and waits; press r to re-check. Nothing runs until all four pass.

2. Select. The full diff of both accounts, one row per GitHub repo with its visibility, size, and last push. Repos missing on the target are selectable; those already there are dimmed. Tick rows with space, filter by name, toggle forks and archived in or out, or hit "Select all missing". The footer keeps a running count and total size of what you have selected.

3. Confirm. A summary of exactly what is about to happen: how many repos, the total size, and the target instance, so nothing migrates by accident.

4. Migrate. Each repo is migrated in turn with a per-repo progress bar and a size-weighted total bar, while a log pane streams the result of every repo as it finishes.

Directions

Direction	How	Transfers	Does not transfer
GitHub → Gitea (default)	tea repos migrate --service github	Code, wiki, LFS, issues, labels, milestones, releases, pull requests	GitHub Actions history, Projects, Discussions, stars, webhooks, branch protection
Gitea → GitHub	git clone --mirror → gh repo create → git push --mirror	Code, all branches and tags, best-effort wiki	Issues and pull requests (GitHub has no import API)

Pass --direction gitea-to-github to reverse, or press d in the UI to flip.

Authentication

migtea never reads, prints, logs, or stores any token. GitHub auth is delegated to gh; Gitea auth is delegated to tea. For private GitHub repositories, migtea hands the output of gh auth token straight to tea's --auth-token flag in memory so Gitea can clone them; the value never touches disk or the log.

Options

migtea [--direction {github-to-gitea,gitea-to-github}] [--dry-run] [--version]

--dry-run walks the entire flow but replaces the migration call with an existence check, so you can rehearse safely before moving anything.

License

Apache-2.0.

---

Copyright © 2026 botmonster.com