Skip to content

How to migrate from Codex to Gemini

aix is a CLI for defining, installing, and syncing AI editor configuration. If you are moving from Codex to Gemini, this guide shows what aix can carry over, what the destination editor calls each feature, and where the destination config lands.

When you are ready to run the move, aix sync codex --to gemini copies the supported config from Codex into Gemini. Use the comparison below first so you know which names, paths, and support differences to expect.

If you want the aix-side definitions first, review rules , prompts , mcp , skills , hooks .

How to use this guide

  • Read across a row to compare the source and destination terms, support, and targets.
  • Each scope line shows both what the editor supports and what aix writes today.
  • Open the destination editor page at the end if you need every path, note, and terminology detail.

The biggest changes are in rules, prompts, mcp.

How to read the statuses

Support key

Editor support

  • Supported The editor exposes that feature at that scope.
  • No support The editor does not expose that feature at that scope.

aix support

  • Native aix writes the editor's own format.
  • Adapter aix keeps the feature through an adapter or alternate representation.
  • No support aix does not write that feature for the destination today.

Use the Project scope and User scope rows to see where config lands at each level.

Feature comparison

Feature-by-feature differences from Codex to Gemini.
Feature Codex Gemini
Rules

AGENTS.md

Project
Editor Supported aix Native
Path AGENTS.md at the project root and selected subdirectories
User
Editor Supported aix Native
Path ~/.codex/AGENTS.md

GEMINI.md

Project
Editor Supported aix Native
Path GEMINI.md
User
Editor Supported aix Native
Path ~/.gemini/GEMINI.md
Prompts

Skills

Project
Editor Supported aix Adapter
Path .agents/skills/prompt-{name}/
aix: Prompts are installed as instruction-only Agent Skills.
User
Editor Supported aix Adapter
Path ~/.codex/skills/prompt-{name}/
aix: User-scoped prompts are also converted to skills.

Commands

Project
Editor Supported aix Native
Path .gemini/commands/*.toml
User
Editor Supported aix Native
Path ~/.gemini/commands/*.toml
MCP

MCP servers

Project
Editor No support aix No support
Editor: The editor does not expose this feature at this scope. aix: aix does not yet write Codex project MCP config.
User
Editor Supported aix Native
Path ~/.codex/config.toml

MCP servers

Project
Editor Supported aix Native
Path .gemini/settings.json
User
Editor Supported aix Native
Path ~/.gemini/settings.json
Skills

Skills

Project
Editor Supported aix Native
Path .agents/skills/{name}/
User
Editor Supported aix Native
Path ~/.codex/skills/{name}/

Skills

Project
Editor Supported aix Native
Path .gemini/skills/{name}/
User
Editor Supported aix Native
Path ~/.gemini/skills/{name}/
Agents

Agents

Project
Editor No support aix No support
Editor: The editor does not expose this feature at this scope. aix: aix reports configured agents as unsupported for Codex.
User
Editor No support aix No support
Editor: The editor does not expose this feature at this scope. aix: aix reports configured agents as unsupported for Codex.

Subagents

Project
Editor Supported aix Native
Path .gemini/agents/*.md
User
Editor Supported aix Native
Path ~/.gemini/agents/*.md
Hooks

Hooks

Project
Editor No support aix No support
Editor: The editor does not expose this feature at this scope. aix: Codex does not support lifecycle hooks in aix.
User
Editor No support aix No support
Editor: The editor does not expose this feature at this scope. aix: Codex does not support lifecycle hooks in aix.

Hooks

Project
Editor Supported aix Native
Path .gemini/settings.json
User
Editor Supported aix Native
Path ~/.gemini/settings.json

Recommended follow-up links