migration-assistant · qdhenry — Claude Code command: system migration
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.
no license ★ 1,357 updated 2026-03-01
.claude/commands/migration-assistant.mdWhat migration-assistant 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.
What it helps with
- 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 for the agent
- 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
How to install migration-assistant
Manually: put the files in place
.claude/commands/migration-assistant.mdCall it with /migration-assistant. For all projects use ~/.claude/commands/
Manually: put the files in place
~/.codex/prompts/migration-assistant.mdCall it with /prompts:migration-assistant. Codex marks this format deprecated in favour of skills
Manually: put the files in place
.github/prompts/migration-assistant.prompt.mdManually: put the files in place
.gemini/commands/migration-assistant.tomlGemini stores commands as TOML: the prompt text goes into the prompt field
Questions about migration-assistant
How to install migration-assistant in Claude Code?
Put the file in .claude/commands/migration-assistant.md — the command becomes available immediately.
What does migration-assistant do?
Migrates issues, PRs and projects between GitHub and Linear, preserves relationships, attachments and metadata, creates rollback points and keeps full operation audit.
Which MCP servers does migration-assistant require?
It needs mcp-server-github and mcp-server-linear, plus installed and authenticated GitHub CLI.
Similar slash commands
All slash commands for Git and GitHub →migration-assistant by other authors comes first.