migrate.md +34 −3
5Codex migrates the parts it can handle directly and can open a follow-up thread5Codex migrates the parts it can handle directly and can open a follow-up thread
6to help migrate anything that remains.6to help migrate anything that remains.
7 7
88<div class="not-prose my-6 max-w-4xl">
9 <CodexScreenshot
10 alt="Import from another agent in General settings"
11 lightSrc="/images/codex/migrate/import-flow-light.png"
12 darkSrc="/images/codex/migrate/import-flow-dark.png"
13 maxHeight="520px"
14 class="p-3 sm:p-4"
15 imageClass="rounded-xl"
16 />
17</div>
9 18
10## Start the migration19## Start the migration
11 20
21<WorkflowSteps>
22
121. Open **Settings** in the Codex app.231. Open **Settings** in the Codex app.
132. On the **General** page, find **Import other agent setup**.242. On the **General** page, find **Import other agent setup**.
143. Select **Import** or **Import again**.253. Select **Import** or **Import again**.
154. Review what Codex found, choose what to bring over, then select **Import**.264. Review what Codex found, choose what to bring over, then select **Import**.
165. After the import finishes, select **View imported files** if you want to inspect the result.275. After the import finishes, select **View imported files** if you want to inspect the result.
17 28
29</WorkflowSteps>
30
18## How migration works31## How migration works
19 32
20Codex checks both your user-level setup and the current project. User-level33Codex checks both your user-level setup and the current project. User-level
52When that happens, Codex shows the remaining setup and offers **Continue in65When that happens, Codex shows the remaining setup and offers **Continue in
53Codex**.66Codex**.
54 67
5568<div class="not-prose my-6 max-w-4xl">
69 <CodexScreenshot
70 alt="Additional setup found after import"
71 lightSrc="/images/codex/migrate/additional-setup-light.png"
72 darkSrc="/images/codex/migrate/additional-setup-dark.png"
73 maxHeight="520px"
74 class="p-6 sm:p-8"
75 imageClass="!w-auto rounded-xl"
76 />
77</div>
56 78
57If you continue, Codex opens a new thread with the remaining work already filled79If you continue, Codex opens a new thread with the remaining work already filled
58in. The thread keeps user-level setup separate from project-level setup so you80in. The thread keeps user-level setup separate from project-level setup so you
59can see where each remaining item belongs.81can see where each remaining item belongs.
60 82
6183<div class="not-prose my-6 max-w-4xl">
84 <CodexScreenshot
85 alt="Follow-up migration task in Codex"
86 lightSrc="/images/codex/migrate/continue-with-codex-light.png"
87 darkSrc="/images/codex/migrate/continue-with-codex-dark.png"
88 maxHeight="320px"
89 class="p-6 sm:p-8"
90 imageClass="rounded-xl"
91 />
92</div>
62 93
63## What to review after import94## What to review after import
64 95