1# Import to Codex1# Import from another agent
2 2
3Use the import flow to bring your instructions, settings, skills, plugins,3Use the import flow to bring your instructions, settings, skills, plugins,
4projects, and recent chat sessions from other agents into Codex. Codex imports4projects, and recent work from other agents into the ChatGPT desktop app. The
5the supported items directly and lets you finish setup for any imported plugins5app imports supported items directly and lets you finish setup for any imported
6or connections that need authorization.6plugins or connections that need authorization.
7 7
8Importing does not change or delete your existing agent setup.8Importing doesn't change or delete your existing agent setup.
9 9
10<div class="not-prose my-6 max-w-5xl">10<div class="not-prose my-6 max-w-5xl">
11 <CodexScreenshot11 <CodexScreenshot
22 22
23<WorkflowSteps>23<WorkflowSteps>
24 24
251. In the Codex app, open **Settings**.251. In the ChatGPT desktop app, open **Settings > Import**. If **Import** isn't
262. Under **General**, find **Import other agent setup**.26 available as a settings section yet, open **General** and find **Import other
273. Select **Import**.27 agent setup**.
284. Choose the agents you want to import from, then select **Continue**.282. Select **Import**.
295. On **Select items to import**, select **Continue** to import everything or **Customize** to choose specific items.293. Choose the agents you want to import from, then select **Continue**.
306. If you customize the import, select the items to bring over, then select **Confirm**.304. On **Select items to import**, select **Continue** to import everything or **Customize** to choose specific items.
317. After the import finishes, open an imported project or thread to continue working.315. If you customize the import, select the items to bring over, then select **Confirm**.
326. After the import finishes, open an imported project or task to continue working.
32 33
33</WorkflowSteps>34</WorkflowSteps>
34 35
35<div class="not-prose my-6 max-w-5xl">36<div class="not-prose my-6 max-w-5xl">
36 <CodexScreenshot37 <CodexScreenshot
37 alt="Select the setup and recent work to import into Codex"38 alt="Select the setup and recent work to import into ChatGPT"
38 lightSrc="/images/codex/import/import-overview.png"39 lightSrc="/images/codex/import/import-overview.png"
39 darkSrc="/images/codex/import/import-overview.png"40 darkSrc="/images/codex/import/import-overview.png"
40 maxHeight="680px"41 maxHeight="680px"
45 46
46## How importing works47## How importing works
47 48
48Codex checks both your user-level setup and your existing projects. User-level49The import flow checks both your user-level setup and your existing projects.
49setup comes from files on your machine. Project-level setup comes from files in50User-level setup comes from files on your machine. Project-level setup comes
50the repositories and folders you select.51from files in the repositories and folders you select.
51 52
52When you import, Codex:53When you import, ChatGPT:
53 54
541. Detects supported setup and recent work.551. Detects supported setup and recent work.
552. Imports the items you select.562. Imports the items you select.
563. Leaves your existing agent setup unchanged.573. Leaves your existing agent setup unchanged.
574. Checks whether imported plugins or connections still need setup.584. Checks whether imported plugins or connections still need setup.
585. Shows a status card when follow-up is required.595. Shows a status card when you need to finish setup.
59 60
60## What Codex can import61## What ChatGPT can import
61 62
62| Imported item | Codex destination |63| Imported item | Destination |
63| ----------------------------------- | -------------------------------------- |64| --------------------------- | ---------------------------------------------------- |
64| Instruction files | [`AGENTS.md`](https://developers.openai.com/codex/guides/agents-md) |65| Instruction files | [`AGENTS.md`](https://learn.chatgpt.com/docs/agent-configuration/agents-md) |
65| `settings.json` | [`config.toml`](https://developers.openai.com/codex/config-basic) |66| `settings.json` | [`config.toml`](https://learn.chatgpt.com/docs/config-file/config-basic) |
66| Skills | [Codex skills](https://developers.openai.com/codex/skills) |67| Skills | [Skills](https://learn.chatgpt.com/docs/build-skills) |
67| Plugins | Codex plugins |68| Plugins | Plugins |
68| Existing project folders | Codex projects using the same folders |69| Existing project folders | Projects using the same folders |
69| Chat sessions from the last 30 days | Codex threads |70| Chats from the last 30 days | ChatGPT tasks |
70| MCP server configuration | [Codex MCP configuration](https://developers.openai.com/codex/mcp) |71| MCP server configuration | [Codex MCP configuration](https://learn.chatgpt.com/docs/extend/mcp) |
71| Hooks | [Codex hooks](https://developers.openai.com/codex/hooks) |72| Hooks | [Codex hooks](https://learn.chatgpt.com/docs/hooks) |
72| Slash commands | [Codex skills](https://developers.openai.com/codex/skills) |73| Slash commands | [Skills](https://learn.chatgpt.com/docs/build-skills) |
73| Subagents | [Codex agents](https://developers.openai.com/codex/subagents) |74| Subagents | [Codex agents](https://learn.chatgpt.com/docs/agent-configuration/subagents) |
74 75
75<div class="not-prose my-6 max-w-5xl">76<div class="not-prose my-6 max-w-5xl">
76 <CodexScreenshot77 <CodexScreenshot
85 86
86## Finish setup after importing87## Finish setup after importing
87 88
88When the import completes, Codex shows a status card in the lower-left corner.89When the import completes, the app shows a status card in the lower-left corner.
89If an imported plugin or connection still needs setup, the card calls it out.90If an imported plugin or connection still needs setup, the card calls it out.
90 91
91When Codex flags an item that needs attention, select **Finish** and follow the92When the app flags an item that needs attention, select **Finish** and follow the
92prompts to complete setup.93prompts to complete setup.
93 94
94## What to review after importing95## What to review after importing
98- Tool restrictions or permissions in imported skills and agents.99- Tool restrictions or permissions in imported skills and agents.
99- MCP server settings that use custom authentication, headers, environment100- MCP server settings that use custom authentication, headers, environment
100 variables, or transports. You may need to sign in again.101 variables, or transports. You may need to sign in again.
101- Hooks whose behavior may differ in Codex.102- Hooks whose behavior may differ after import.
102- Plugins, marketplaces, or other setup that needs manual follow-up.103- Plugins, marketplaces, or other setup that needs manual follow-up.
103- Prompt templates or command-style prompts that depend on arguments, shell104- Prompt templates or command-style prompts that depend on arguments, shell
104 interpolation, or file-path placeholders.105 interpolation, or file-path placeholders.
106## After you import107## After you import
107 108
108Once the import finishes, open one of your imported projects and continue from109Once the import finishes, open one of your imported projects and continue from
109there. If you are new to Codex, see the [quickstart](https://developers.openai.com/codex/quickstart) for the110there. See [Use ChatGPT](https://learn.chatgpt.com/docs/use-chatgpt) for guidance on starting your
110rest of the setup flow.111next task.