# migrate

migrate — a slash command that takes a project off Task Master MCP and onto task files in markdown, carrying open tasks over before clearing the old setup.

- command · `type=command` · Claude Code, Codex, GitHub Copilot, Gemini CLI · ★ 155 repo stars
- Author: serpro69
- License: Elastic-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/serpro69/claude-toolbox/tree/HEAD/klaude-plugin/commands/migrate-from-taskmaster/migrate.md
- Updated: 2026-10-29
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/commands/migrate

## What it does

The command moves a project off Task Master MCP and onto task files in markdown. First a check for leftovers: `.taskmaster/`, `.claude/commands/tm/`, the `task-orchestrator`, `task-executor` and `task-checker` agents, `task-master-ai` entries in `.claude/settings.json`, Task Master headings in `CLAUDE.md`. Find none of those and it says there is nothing to migrate, then stops.

Open tasks arrive through the `mcp__task-master-ai__get_tasks` tool, asked for `pending` items with subtasks; with no MCP server attached it falls back to `.taskmaster/tasks/tasks.json`. Statuses get remapped: `deferred` turns into `blocked` with the reason kept, `review` becomes `in-progress`, `done` and `cancelled` are dropped. Each feature lands in `/docs/feat/wip/[feature]/tasks.md`, shaped after `../../skills/design/example-tasks.md`, and you see the list before anything is deleted.

Cleanup takes the `.taskmaster/` tree, `.claude/commands/tm/`, the task agent files, Task Master sections in `CLAUDE.md` and the allow/deny entries in `.claude/settings.json`; the template-sync script is refetched with `curl`. Your `~/.claude.json` stays untouched, so pulling the `task-master-ai` entry out of `mcpServers` is on you. A closing summary suggests `/clear` once the permission config changed.

## Install

### Claude Code (native platform)

1. **Plugin marketplace**
In the agent chat (not a shell):
```text
/plugin marketplace add serpro69/claude-toolbox
```
In the agent chat (not a shell):
```text
/plugin install kk@claude-toolbox
```

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

### Codex

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

### GitHub Copilot

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

### Gemini CLI

**Manually: put the files in place**
- File: `.gemini/commands/migrate.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/serpro69/claude-toolbox/tree/HEAD/klaude-plugin/commands/migrate-from-taskmaster/migrate.md

## When to use it
- port open Task Master tasks into markdown files
- strip `.taskmaster/` and the `tm/` slash commands from a repo
- drop `task-master-ai` permissions from `.claude/settings.json`
- clear Task Master sections out of `CLAUDE.md`
- refresh the template-sync script after the switch

## Example prompts
- Run `/migrate` and list the open Task Master tasks before writing anything
- \`/migrate` on this repo, and stop early if there is no `.taskmaster/` here
- Go through `/migrate` but show me every file you plan to delete first

## Similar
- [memory-migrate](https://affpapa.org/en/nevibecode/commands/memory-migrate.md) — command · ★ 730 repo stars
- [convex-migrate](https://affpapa.org/en/nevibecode/skills/convex-migrate.md) — skill · 44100 installs
- [plan](https://affpapa.org/en/nevibecode/commands/disler-plan.md) — command · ★ 3990 repo stars
- [todo](https://affpapa.org/en/nevibecode/commands/todo.md) — command · 2723 installs
- [migrate-mstest-v3-to-v4](https://affpapa.org/en/nevibecode/skills/migrate-mstest-v3-to-v4.md) — skill · 4200 installs
- [migrate-to-parallel](https://affpapa.org/en/nevibecode/skills/migrate-to-parallel.md) — skill · 3800 installs

From the same set: [serpro69/claude-toolbox](https://affpapa.org/en/nevibecode/by/serpro69/claude-toolbox.md) — 30 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
