import.md +110 −0 created
1# Import to Codex
2
3Use the import flow to bring your instructions, settings, skills, plugins,
4projects, and recent chat sessions from other agents into Codex. Codex imports
5the supported items directly and lets you finish setup for any imported plugins
6or connections that need authorization.
7
8Importing does not change or delete your existing agent setup.
9
10<div class="not-prose my-6 max-w-5xl">
11 <CodexScreenshot
12 alt="Choose the other AI apps to import from"
13 lightSrc="/images/codex/import/import-source.png"
14 darkSrc="/images/codex/import/import-source.png"
15 maxHeight="680px"
16 variant="no-wallpaper"
17 imageClass="rounded-xl"
18 />
19</div>
20
21## Start an import
22
23<WorkflowSteps>
24
251. In the Codex app, open **Settings**.
262. Under **General**, find **Import other agent setup**.
273. Select **Import**.
284. Choose the agents you want to import from, then select **Continue**.
295. On **Select items to import**, select **Continue** to import everything or **Customize** to choose specific items.
306. If you customize the import, select the items to bring over, then select **Confirm**.
317. After the import finishes, open an imported project or thread to continue working.
32
33</WorkflowSteps>
34
35<div class="not-prose my-6 max-w-5xl">
36 <CodexScreenshot
37 alt="Select the setup and recent work to import into Codex"
38 lightSrc="/images/codex/import/import-overview.png"
39 darkSrc="/images/codex/import/import-overview.png"
40 maxHeight="680px"
41 variant="no-wallpaper"
42 imageClass="rounded-xl"
43 />
44</div>
45
46## How importing works
47
48Codex checks both your user-level setup and your existing projects. User-level
49setup comes from files on your machine. Project-level setup comes from files in
50the repositories and folders you select.
51
52When you import, Codex:
53
541. Detects supported setup and recent work.
552. Imports the items you select.
563. Leaves your existing agent setup unchanged.
574. Checks whether imported plugins or connections still need setup.
585. Shows a status card when follow-up is required.
59
60## What Codex can import
61
62| Imported item | Codex destination |
63| ----------------------------------- | -------------------------------------- |
64| Instruction files | [`AGENTS.md`](https://developers.openai.com/codex/guides/agents-md) |
65| `settings.json` | [`config.toml`](https://developers.openai.com/codex/config-basic) |
66| Skills | [Codex skills](https://developers.openai.com/codex/skills) |
67| Plugins | Codex plugins |
68| Existing project folders | Codex projects using the same folders |
69| Chat sessions from the last 30 days | Codex threads |
70| MCP server configuration | [Codex MCP configuration](https://developers.openai.com/codex/mcp) |
71| Hooks | [Codex hooks](https://developers.openai.com/codex/hooks) |
72| Slash commands | [Codex skills](https://developers.openai.com/codex/skills) |
73| Subagents | [Codex agents](https://developers.openai.com/codex/subagents) |
74
75<div class="not-prose my-6 max-w-5xl">
76 <CodexScreenshot
77 alt="Choose the instructions, settings, skills, plugins, projects, and chats to import"
78 lightSrc="/images/codex/import/import-instructions.png"
79 darkSrc="/images/codex/import/import-instructions.png"
80 maxHeight="680px"
81 variant="no-wallpaper"
82 imageClass="rounded-xl"
83 />
84</div>
85
86## Finish setup after importing
87
88When the import completes, Codex shows a status card in the lower-left corner.
89If an imported plugin or connection still needs setup, the card calls it out.
90
91When Codex flags an item that needs attention, select **Finish** and follow the
92prompts to complete setup.
93
94## What to review after importing
95
96Review imported setup before you rely on it, especially:
97
98- Tool restrictions or permissions in imported skills and agents.
99- MCP server settings that use custom authentication, headers, environment
100 variables, or transports. You may need to sign in again.
101- Hooks whose behavior may differ in Codex.
102- Plugins, marketplaces, or other setup that needs manual follow-up.
103- Prompt templates or command-style prompts that depend on arguments, shell
104 interpolation, or file-path placeholders.
105
106## After you import
107
108Once 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 the
110rest of the setup flow.