migrate

migrate is a command for Claude Code from gopherguides/gopher-ai. It costs 14 tokens per session (8,700 once invoked), scanned A, original, MIT.

A migration command for changing Tailwind CSS v3 configuration to the CSS-based format used by v4. It converts theme settings, source paths, CSS syntax, and related dependencies.

In plain words
What is it for?
Use it to migrate a project, preview the changes, keep the old configuration, or create backups before editing.
Why use it?
It reduces the manual changes needed when upgrading an existing Tailwind project between major versions.

Command for Claude Code

Written for Claude Code: allowed-tools in frontmatter. Also seen: names the AskUserQuestion tool; mentions Claude Code.

Runs only inside its plugin — its command needs a path that Claude Code sets for a plugin’s own hooks and for nothing else. Install the plugin, not this.

Part of the tailwind plugin — 5 skills, 4 commands shipped together

Good fit Use it to migrate a project, preview the changes, keep the old configuration, or create backups before editing.

Compare 6 commands from other repositories ↓
Install

Getting it into your agent

This one installs as part of its plugin. Adding the marketplace and installing the plugin brings it with everything else the plugin ships.

Claude Code
/plugin marketplace add gopherguides/gopher-ai
Claude Code
/plugin install tailwind

Made for: Claude Code.

Or install tailwind, the plugin that ships this one along with the rest of its 5 skills, 4 commands.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for migrate

README.md
[![agentmods](https://agentmods.dev/badge/commands/gopherguides/gopher-ai/migrate/github.svg)](https://agentmods.dev/commands/gopherguides/gopher-ai/migrate)
Your own site
<a href="https://agentmods.dev/commands/gopherguides/gopher-ai/migrate"><img src="https://agentmods.dev/badge/commands/gopherguides/gopher-ai/migrate/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for migrate

Your own site · 80×15
<a href="https://agentmods.dev/commands/gopherguides/gopher-ai/migrate"><img src="https://agentmods.dev/badge/commands/gopherguides/gopher-ai/migrate.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 14 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 8,700 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00014 $0.08700
Opus 5.5 $0.00006 $0.03480
Sonnet 5.5 $0.00003 $0.01740
Haiku 4.5 $0.00001 $0.00870

Measured 1mo ago against content hash f8305636f471, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

migrate scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 1mo ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

plugins/tailwind/commands/migrate.md · 803 lines

How it starts

The opening of the file, as written. The whole thing — 803 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Migrate Tailwind CSS v3 to v4

If $ARGUMENTS is empty or not provided:

Migrate Tailwind CSS v3 configuration to v4's CSS-based configuration.

Usage: /tailwind-migrate [options]

  • /tailwind-migrate — migrate v3 to v4
  • /tailwind-migrate --check — preview changes without modifying files

What it does: finds tailwind.config.js/.ts → converts theme to @theme directive → converts content paths to @source directives → updates CSS files to @import "tailwindcss" syntax → updates package.json deps → optionally removes the old config file.

Key v4 changes:

v3 v4
tailwind.config.js CSS @theme { } directive
@tailwind base/components/utilities @import "tailwindcss"
darkMode: 'class' @custom-variant dark (...) plus .dark { } overrides
theme.extend.colors --color-* CSS variables

Proceed with migration.


If $ARGUMENTS is provided:

Parse arguments:

  • --check — preview changes without modifying files
  • --keep-config — keep old config file after migration (for reference)
  • --backup — create backup files before modifying

Read-only Preview (--check)

When --check is present, capture the initial repository status, then follow Steps 1-3 to analyze the v3 project and generate proposed v4 content in the response. In Steps 4-7, describe the exact file, package, and configuration changes that normal migration mode would make without applying them.

Do not edit files, install or remove dependencies, rename or delete configuration, or run a build that overwrites generated CSS. Skip mutation-specific questions and record the recommended old-config disposition as a preview item instead. Use the Preview Completion Criteria at the end of this workflow rather than the mutation criteria.

Without --check, perform the migration and use the Migration Completion Criteria.

Preservation Flags

When --backup is present and --check is absent, create backups before the first mutation. Back up every file that the migration will modify or remove, including affected CSS, package.json, the active lockfile, PostCSS configuration, and the v3 Tailwind configuration. Use a .tailwind-v3.bak suffix and a numbered suffix when that path already exists. Record every source-to-backup mapping. If any backup fails, stop before making changes.

Read the full file on GitHub · 803 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 1mo ago Changed f8305636f471
  2. 1mo ago First seen · 803 lines · 14 tokens per session scan A 7d8ca1e434d5

Subscribe to this mod's changes

migrate is a command published in the GitHub repository gopherguides/gopher-ai (21 stars, last pushed yesterday), licensed MIT. It adds 14 tokens to every session and 8,700 once invoked, about $0.0001 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-03.