# migration-assistant

migration-assistant — a Claude Code command that migrates issues, PRs and projects between GitHub and Linear. Works via GitHub CLI and Linear MCP server, preserves relationships and creates rollback points.

- command · `type=command` · Claude Code, Codex, GitHub Copilot, Gemini CLI · ★ 1357 repo stars
- Author: qdhenry
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/qdhenry/Claude-Command-Suite/tree/HEAD/.claude/commands/team/migration-assistant.md
- Updated: 2026-03-01
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/commands/qdhenry-migration-assistant

## What it does

The command plans and executes data migration between GitHub and Linear: transfers issues, pull requests, projects, labels, attachments and item relationships. Runs in five phases — analysis, preparation, migration, verification, finalization. Supports checkpoint recovery: if migration stops, it resumes from the last saved position. Creates full backup of source data and logs every operation.

Requires installed and authenticated GitHub CLI (`gh`) and connected Linear MCP server. The command reads YAML mapping config to correctly match statuses, labels, cycles and custom fields between systems. Dry-run mode lets you validate the migration plan without actual data transfer.

Rollback works by transaction ID and restores the original state while keeping audit logs. The command produces detailed reports for each phase: item counts, errors, execution time and recommendations.

## Install

### Claude Code (native platform)

**Manually: put the files in place**
- File: `.claude/commands/migration-assistant.md` — Call it with /migration-assistant. For all projects use ~/.claude/commands/

### Codex

**Manually: put the files in place**
- File: `~/.codex/prompts/migration-assistant.md` — Call it with /prompts:migration-assistant. Codex marks this format deprecated in favour of skills

### GitHub Copilot

**Manually: put the files in place**
- File: `.github/prompts/migration-assistant.prompt.md`

### Gemini CLI

**Manually: put the files in place**
- File: `.gemini/commands/migration-assistant.toml` — Gemini stores commands as TOML: the prompt text goes into the prompt field

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/qdhenry/Claude-Command-Suite/tree/HEAD/.claude/commands/team/migration-assistant.md

## When to use it
- migrate issues and PRs from GitHub to Linear with relationship preservation
- check data compatibility before migration and estimate time required
- roll back migration to previous state using checkpoint recovery
- configure custom field mapping between systems via YAML config
- migrate data in batches with logging for every operation

## Example prompts
- Plan a migration from GitHub to Linear and show what needs configuration
- Analyze how many issues need migration and which fields are incompatible
- Run migration in dry-run mode with four parallel threads and checkpoints

## Similar
- [sync-migration-assistant](https://affpapa.org/en/nevibecode/commands/sync-migration-assistant.md) — command · 120 installs
- [bulk-import-issues](https://affpapa.org/en/nevibecode/commands/bulk-import-issues.md) — command · 129 installs
- [issue-fields-migration](https://affpapa.org/en/nevibecode/skills/issue-fields-migration.md) — skill · 1900 installs
- [tigris-s3-migration](https://affpapa.org/en/nevibecode/skills/tigris-s3-migration.md) — skill · 3800 installs
- [gitbackup-github-desktop](https://affpapa.org/en/nevibecode/skills/gitbackup-github-desktop.md) — skill · 278 installs
- [Linear Automation](https://affpapa.org/en/nevibecode/skills/linear-automation.md) — skill · 4800 installs

## Other versions with the same name
- [migration-assistant · davila7](https://affpapa.org/en/nevibecode/commands/migration-assistant.md) — 183 installs

From the same set: [qdhenry/claude-command-suite](https://affpapa.org/en/nevibecode/by/qdhenry/claude-command-suite.md) — 112 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
