Import from another agent
For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending
.mdto the page URL.
Use the import flow to bring instructions, settings, skills, plugins, projects, and recent work from another agent into the ChatGPT desktop app or Codex CLI. Codex CLI can import from Claude Code or Cursor. The desktop app supports Claude Code, with Cursor import available as it rolls out.
The desktop app imports supported items directly and lets you finish setup for imported plugins or connections that need authorization.
Importing doesn't change or delete your existing agent setup.
Start an import
Import in the desktop app
- In the ChatGPT desktop app, open Settings > Import. If Import isn't available as a settings section yet, open General and find Import other agent setup.
- Select Import.
- Choose the agents you want to import from, then select Continue.
- On Select items to import, choose what to bring over, then select Continue.
- After the import finishes, open an imported project or chat to continue working.
Import in Codex CLI
- Start a local Codex CLI session and type
/import. - Choose Claude Code or Cursor.
- Select the supported setup, project files, and recent chats you want to import.
- Review the imported configuration and continue working in Codex.
Codex CLI imports up to 50 chats from the last 30 days. The /import command
isn't available during a running task, in a remote session, or while connected
to a local app-server daemon. See CLI slash
commands.
How importing works
The import flow checks both your user-level setup and your existing projects. User-level setup comes from files on your machine. Project-level setup comes from files in the repositories and folders you select.
When you import, ChatGPT:
- Detects supported setup and recent work.
- Imports the items you select.
- Leaves your existing agent setup unchanged.
- Checks whether imported plugins or connections still need setup.
- Shows a status card when you need to finish setup.
What ChatGPT can import
| Imported item | Destination |
|---|---|
| Instruction files | AGENTS.md |
settings.json |
config.toml |
| Skills | Skills |
| Plugins | Plugins |
| Existing project folders | Projects using the same folders |
| Project memories from Claude Code | Memories |
| Chats from the last 30 days | ChatGPT chats |
| MCP server configuration | Codex MCP configuration |
| Hooks | Codex hooks |
| Slash commands | Skills |
| Subagents | Codex agents |
Finish setup after importing
When the import completes, the app shows a status card in the lower-left corner. If an imported plugin or connection still needs setup, the card calls it out.
When the app flags an item that needs attention, select Finish and follow the prompts to complete setup.
What to review after importing
Review imported setup before you rely on it, especially:
- Tool restrictions or permissions in imported skills and agents.
- MCP server settings that use custom authentication, headers, environment variables, or transports. You may need to sign in again.
- Hooks whose behavior may differ after import.
- Plugins, marketplaces, or other setup that needs manual follow-up.
- Prompt templates or command-style prompts that depend on arguments, shell interpolation, or file-path placeholders.
After you import
Once the import finishes, open one of your imported projects and continue from there. See Use ChatGPT for guidance on starting your next task.