Skip to main content
command CX Codex

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

Install into Claude Code · Manually: put the files in place All methods and platforms ↓
.claude/commands/migration-assistant.md
Open on GitHub

What 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.md

Call it with /migration-assistant. For all projects use ~/.claude/commands/

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.

migration-assistant davila7 The migration-assistant command for Claude Code helps plan and run migrations, verify results, and prepare a rollback. It works with GitHub CLI and Linear MCP. CX Codex +1 183installs sync-migration-assistant davila7 sync-migration-assistant — a slash command that migrates issues between GitHub and Linear with validation and rollback. Useful when a project changes trackers. CX Codex +1 120installs bulk-import-issues davila7 bulk-import-issues — a Claude Code command that moves GitHub issues into Linear in bulk. You run it with flags for state, labels, milestones and batch size. CX Codex +1 129installs issue-fields-migration official github issue-fields-migration is a GitHub Copilot skill that moves repository label metadata or Project V2 values into GitHub issue fields. It supports the move to structured issue metadata. CX Codex +1 1,900installs tigris-s3-migration tigrisdata tigris-s3-migration — a skill that walks an object-storage migration from AWS S3, GCS or Azure Blob to Tigris. Useful when a bucket has to switch over without taking production down. CX Codex +1 3,800installs gitbackup-github-desktop reason-machines gitbackup-github-desktop helps configure an Electron desktop app to mirror GitHub repositories locally and upload compressed archives to AWS S3 or Cloudflare R2. CX Codex +1 278installs Linear Automation Claude Office Skills Linear Automation automates Linear issue tracking, Git branch and PR syncing, and two-week cycle planning through project-mcp tools. CX Codex +1 4,800installs

From the same set112

The whole set →
rule2hook rule2hook translates plain language instructions from memory files into automated Claude Code hook definitions inside hooks.json. CX Codex +1 ★ 1,357repo stars handoff This command saves the work so far as a Markdown handoff for a later session. Run it before changing tasks or when the context window is nearly full. CX Codex +1 ★ 1,357repo stars mobile-developer mobile-developer — a Claude subagent for React Native and Flutter apps. It designs the architecture, hooks up native modules and handles offline sync, push and store releases. CX Codex ★ 1,357repo stars security-auditor security-auditor is a Claude Code subagent that finds application vulnerabilities and reviews security controls. It can assess source code, authentication flows, or a running application. CX Codex ★ 1,357repo stars deployment-engineer deployment-engineer — a Claude subagent that drafts CI/CD pipelines, container builds and cloud infrastructure, then hands over a deployment runbook. CX Codex ★ 1,357repo stars architecture-auditor architecture-auditor audits software structure, design patterns, and layer separation. Helps spot circular imports and god objects before major refactoring. CX Codex ★ 1,357repo stars prompt-engineer The prompt-engineer subagent for Claude Code designs prompts, agent workflows, and structured outputs. It helps clarify instructions and safety constraints. CX Codex ★ 1,357repo stars quickstart quickstart is a command that guides a first run of the skill builder, from task questions to a validated skill with examples. CX Codex +1 ★ 1,357repo stars

Project sponsors

Companies that keep this analytics open