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-runOr from inside a session:
/migrate
/migrate codex --dry-run
/migrate --yesDetails
- Detects Codex config at
~/.codex/config.toml,~/.codex/AGENTS.md,~/.codex/prompts/, and.codex/config.tomlin the current project - Detects Gemini CLI config at
~/.gemini/settings.json,~/.gemini/GEMINI.md,~/.gemini/commands/, andGEMINI.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. Runclaude migratefrom 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-codefallback skill listing each one with guidance - On surfaces without an interactive picker,
/migrateasks Claude to summarize what was found and guide the user to run--yesor 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.