# Migrate to Warp from iTerm2

> Import your iTerm2 profile into Warp to transfer themes, fonts, keybindings, hotkey windows, and more in a few clicks.

- 网址：https://funcoding.ai/agents/warp/getting-started/migrate-to-warp/migrate-to-warp-from-iterm2/
- 来源：Warp 官方文档原文（英文），MIT 许可，同步于 2026-10-11
- 官方原文：https://docs.warp.dev/getting-started/migrate-to-warp/migrate-to-warp-from-iterm2/

---
Warp imports your iTerm2 profile automatically, bringing over theme, font, keybindings, hotkey window, and more in a few clicks. This page walks through the importer, what it covers, and what to reconfigure manually after.

## What transfers automatically

Warp ships a built-in iTerm2 importer that reads your default profile from `~/Library/Preferences/com.googlecode.iterm2.plist`. It imports:

* **Theme** - foreground, background, cursor, and all 16 ANSI colors (light and dark variants if configured).
* **Font** - family and size (when the font exists on your system and is supported by Warp).
* **Default shell** - if you've set a custom Command in your iTerm2 profile.
* **Working directory behavior** - Warp translates iTerm2's "Reuse previous session's directory" and similar options.
* **Window dimensions** - rows and columns.
* **Opacity and blur.**
* **Copy-on-select, mouse and scroll reporting, and Option-as-Meta settings.**
* **Global hotkey** - if you use a hotkey window or hotkey activation, Warp maps it.

To run the importer:

1. In Warp, open the [Command Palette](https://funcoding.ai/agents/warp/terminal/command-palette/).
2. Search for **Import External Settings**.
3. Select **iTerm2 Profile: Default**. Warp only imports the profile marked as your Default Bookmark in iTerm2.
4. Choose which settings to keep or skip on the preview screen.

<figure>
![Select a settings profile to import](https://funcoding.ai/official-assets/warp/src/assets/terminal/migrate-to-warp.webp)
<figcaption>Select a settings profile to import.</figcaption>
</figure>

## Use Warp's Agent for follow-up settings

If the importer doesn't pick up something you care about, such as a non-default profile, an unusual keybinding, or a specific setting, ask Warp's Agent to translate it directly. Warp ships a [`settings.toml` file](https://funcoding.ai/agents/warp/terminal/settings/) and a bundled `modify-settings` skill that lets the Agent read your iTerm2 plist and write equivalent values into Warp's settings.

1. In the Warp app, switch to [Agent Mode](https://funcoding.ai/agents/warp/agents/local-agents/interacting-with-agents/terminal-and-agent-modes/) with `⌘+I`.
2. Paste this prompt into Agent Mode, then press `Enter`.

   > Read my iTerm2 preferences with `defaults read com.googlecode.iterm2` and port any settings that the importer didn't cover (extra profiles, custom keybindings) into my Warp `settings.toml` using the `modify-settings` skill. Show me a diff before applying.

3. Review the proposed diff, then approve the changes. Warp hot-reloads `settings.toml`.

## What to reconfigure manually

A few iTerm2 features don't map directly and need a manual pass after import:

* **Multiple profiles.** Warp imports only your Default profile. If you rely on multiple iTerm2 profiles, create equivalent [tab configs](https://funcoding.ai/agents/warp/terminal/windows/tab-configs/) in Warp.
* **Keyboard shortcuts.** Warp's [keyboard shortcuts](https://funcoding.ai/agents/warp/getting-started/keyboard-shortcuts/) cover most iTerm2 bindings out of the box, but custom bindings need to be recreated in **Settings** > **Keyboard shortcuts**.
* **Split panes and arrangements.** Rebuild using [split panes](https://funcoding.ai/agents/warp/terminal/windows/split-panes/) and [tab configs](https://funcoding.ai/agents/warp/terminal/windows/tab-configs/).
* **Triggers.** Warp doesn't have a direct equivalent. Reach similar outcomes through [YAML workflows](https://funcoding.ai/agents/warp/terminal/entry/yaml-workflows/) or Agent Mode.

### Choose your prompt

After the import, choose which [prompt](https://funcoding.ai/agents/warp/terminal/appearance/prompt/) to use:

1. [**Warp prompt**](https://funcoding.ai/agents/warp/terminal/appearance/prompt/#warp-prompt) - Warp's native prompt with drag-and-drop context chips for git branch, directory, timestamps, and more. Configure in **Settings** > **Appearance** > **Prompt**.
2. [**Shell prompt (PS1)**](https://funcoding.ai/agents/warp/terminal/appearance/prompt/#shell-prompt-ps1) - inherits your existing shell prompt configuration unchanged. Pick this if you want Warp to match your iTerm2 prompt exactly.

## Warp-native equivalents

Use this table to find Warp equivalents for iTerm2 features you might look for after switching:

| From iTerm2 | In Warp |
| --- | --- |
| Hotkey window (Quake mode) | [Global hotkey](https://funcoding.ai/agents/warp/terminal/windows/global-hotkey/) (imported automatically when detected in your iTerm2 profile) |
| Triggers | [YAML workflows](https://funcoding.ai/agents/warp/terminal/entry/yaml-workflows/) for repeatable actions; Agent Mode for pattern-based automation |
| Profiles | [Tab configs](https://funcoding.ai/agents/warp/terminal/windows/tab-configs/) for layouts; [Warp Drive](https://funcoding.ai/agents/warp/knowledge-and-collaboration/warp-drive/) for shared team setups |
| Autocomplete menu | [Autosuggestions](https://funcoding.ai/agents/warp/terminal/command-completions/autosuggestions/) + [tab completions](https://funcoding.ai/agents/warp/terminal/command-completions/completions/) |
| Instant replay | [Session restoration](https://funcoding.ai/agents/warp/terminal/sessions/session-restoration/) |
| Password manager integration | [Warp Drive environment variables](https://funcoding.ai/agents/warp/knowledge-and-collaboration/warp-drive/environment-variables/) |

For more on what you can configure after migrating, see the [Warp quickstart](https://funcoding.ai/agents/warp/quickstart/) and [Customizing Warp](https://funcoding.ai/agents/warp/getting-started/quickstart/customizing-warp/).