Source Intelligence
Follow Discord

DisclaimerUnofficial, and not affiliated with Anthropic. Nearly all of this is read straight out of what ships: npm bundles, captured prompts, published docs. Anthropic's own notes go in verbatim, marked as theirs. The rest is my reading, and every entry carries the strings behind it. If one looks wrong, vote it down and say why.

← All of v2.1.182 Home All releases ←olderv2.1.181 v2.1.183newer→
Claude Code v2.1.182

/migrate — Import config from Codex or Gemini CLI

What

A new slash command and CLI subcommand that scans for OpenAI Codex or Google Gemini CLI configuration and imports compatible items into Claude Code.

Usage
# Interactive TUI picker (terminal only)
claude migrate

# Import from a specific agent
claude migrate codex
claude migrate gemini

# Preview without writing anything
claude migrate --dry-run

# Non-interactive: auto-import user-level items (skips ⚠-flagged and project-level items)
claude migrate --yes
claude migrate codex --yes --dry-run

Or from inside a session:

/migrate
/migrate codex --dry-run
/migrate --yes
Details
  • Detects Codex config at ~/.codex/config.toml, ~/.codex/AGENTS.md, ~/.codex/prompts/, and .codex/config.toml in the current project
  • Detects Gemini CLI config at ~/.gemini/settings.json, ~/.gemini/GEMINI.md, ~/.gemini/commands/, and GEMINI.md / .gemini/ in the current project
  • Importable item types: MCP servers, slash commands, subagents, skill directories, and instruction files (AGENTS.md / AGENTS.override.md / GEMINI.md → CLAUDE.md)
  • Items requiring extra review are flagged with ⚠ and held back by --yes; they can be individually toggled in the terminal checkbox picker
  • Project-level config (from .codex/ or .gemini/ in the repo) is detected and listed but never auto-imported — project config can be authored by anyone with write access to that repo. Run claude migrate from a terminal to review project items individually
  • Items that cannot be mapped automatically (hooks, sandbox settings, named profiles, Gemini extensions) generate a /migrate-to-claude-code fallback skill listing each one with guidance
  • On surfaces without an interactive picker, /migrate asks Claude to summarize what was found and guide the user to run --yes or use the terminal
  • Path-traversal guards prevent importing files that escape the config directory (symlinks and .. components are rejected)
  • Files exceeding the size limit are refused with "file exceeds MIGRATE_MAX_FILE_BYTES; refusing to load"
Evidence

Full migration subsystem — search for "Import config from another AI coding agent (Codex, Gemini CLI)" and "claude migrate [codex|gemini] [--dry-run] [--yes]"

Strings lifted out of the shipped bundle, so the claim above can be checked against them.

Related

Other releases about the same thing. Found by shared names or similar wording; neither means one caused the other.

See this entry in the whole of v2.1.182 →