{
  "$schema": "https://bringyour.ai/schemas/claude-code-to-codex-tools.v1.json",
  "id": "bringyour-claude-code-to-codex-tools",
  "title": "Claude Code to Codex migration tools comparison",
  "url": "https://bringyour.ai/claude-code-to-codex-tools",
  "html_url": "https://bringyour.ai/claude-code-to-codex-tools",
  "json_url": "https://bringyour.ai/claude-code-to-codex-tools.json",
  "product": "Bring Your AI",
  "updated_at": "2026-05-12",
  "positioning": "Use first-party Codex import first, then validate local harness behavior that import cannot prove.",
  "remote_invariant": {
    "harness_data_remote": false,
    "accepts_user_rules": false,
    "accepts_file_contents": false,
    "accepts_api_keys": false,
    "notes": "This comparison is descriptive only. Bring Your AI remote routes do not accept harness files, generated memories, user rules, API keys, GitHub handles, repo paths, MCP config files, or file contents."
  },
  "comparison": [
    {
      "id": "codex_first_party_import",
      "name": "Codex first-party import",
      "best_for": "Creating the initial Codex-side checklist and baseline import.",
      "limitation": "Cannot independently prove hook parity, MCP secret-reference safety, source-only path rewrites, or whether session artifacts became active instructions.",
      "bringyour_role": "Run after import as a local validation pass."
    },
    {
      "id": "manual_agents_md",
      "name": "Manual AGENTS.md / CLAUDE.md editing",
      "best_for": "Small repos where the only meaningful state is one instruction file.",
      "limitation": "Easy to miss nested rules, managed policy, skills, MCP wrappers, hooks, generated artifacts, and rollback proof.",
      "bringyour_role": "Inventory and classify non-file-copy migration surfaces before editing by hand."
    },
    {
      "id": "local_bringyour_cli",
      "name": "Bring Your AI local CLI",
      "best_for": "Moving real harness state while keeping source data local and recording non-equivalent behavior.",
      "limitation": "Paid local CLI is required for actual migration writes.",
      "bringyour_role": "Preview for free remotely; migrate locally with merge policy after license activation."
    },
    {
      "id": "remote_mcp_discovery",
      "name": "Bring Your AI remote MCP discovery",
      "best_for": "Agent discovery, target list, install instructions, product quote, and checkout handoff.",
      "limitation": "By design, remote MCP does not accept harness files or config contents.",
      "bringyour_role": "Keep remote surfaces no-data; do all sensitive migration work locally."
    }
  ],
  "decision_rules": [
    "If you only need an initial Codex checklist, use the first-party import.",
    "If the setup includes hooks, MCP servers, skills, generated memories, or managed policy, add a local validation pass.",
    "If MCP config includes env, Keychain, 1Password, or vault helpers, never paste literal values into the target.",
    "If session logs or generated artifacts are useful only as history, keep them as reference notes instead of active instructions.",
    "If Codex will edit production code after import, take a rollback snapshot before the first write."
  ],
  "local_commands": [
    "bringyour preview --from claude-code --to codex",
    "bringyour migrate --from claude-code --to codex --policy merge"
  ],
  "agent_readable_surfaces": {
    "openapi": "https://bringyour.ai/openapi.yaml",
    "agent_manifest": "https://bringyour.ai/.well-known/agent.json",
    "commerce_manifest": "https://bringyour.ai/.well-known/commerce.json",
    "catalog": "https://bringyour.ai/api/v1/catalog",
    "quote": "https://bringyour.ai/api/v1/quote",
    "checkout": "https://bringyour.ai/api/v1/checkout"
  },
  "related_guides": {
    "claude_code_to_codex": "https://bringyour.ai/claude-code-to-codex.json",
    "codex_import_checklist": "https://bringyour.ai/codex-import-checklist.json",
    "codex_import_audit": "https://bringyour.ai/codex-import-audit.json",
    "mcp_config_migration": "https://bringyour.ai/mcp-config-migration.json",
    "agents_md_claude_md": "https://bringyour.ai/agents-md-claude-md.json"
  }
}