> For the complete documentation index, see [llms.txt](/llms.txt).
> Markdown versions of each page are available by appending .md to any URL.

# Migrate to Warp from Ghostty

Moving to Warp from Ghostty? Here's how to bring over your themes, fonts, and keybindings, plus where to find Warp's equivalents for Ghostty's native features.

Warp gives Ghostty users a fast path to bring over themes, fonts, and keybindings, plus native equivalents for the Ghostty features you rely on, from the quick terminal to native tabs and splits.

## What Warp can help transfer

Warp doesn’t have a one-click Ghostty importer. Because Ghostty stores its configuration in a plain-text key-value file at `~/.config/ghostty/config`, Warp’s Agent can read that file and translate matching values into Warp’s `settings.toml`.

## Use Warp’s Agent to migrate your settings (recommended)

The fastest way to bring over your Ghostty setup is to ask Warp’s Agent to translate your config directly. Warp ships a [`settings.toml` file](/terminal/settings/) and a bundled `modify-settings` skill that lets the Agent read your existing config and write equivalent values into Warp’s settings, including translating your Ghostty theme into a Warp [custom theme](/terminal/appearance/custom-themes/).

1.  In the Warp app, open a new tab and switch to [Agent Mode](/agent-platform/local-agents/overview/) with `⌘+I` (macOS) or `Ctrl+I` (Linux/Windows).
    
2.  Paste this prompt into Agent Mode, then press `Enter`.
    
    > Read my Ghostty config at `~/.config/ghostty/config` and any referenced theme files in `~/.config/ghostty/themes/`. Port the equivalent settings (theme, font, keybindings, shell) into my Warp `settings.toml` using the `modify-settings` skill, and create a matching custom theme. Show me a diff before applying.
    
3.  Review the proposed diff, then approve the changes. Warp hot-reloads `settings.toml`, so changes take effect immediately.
    

If you’d rather configure each setting manually through the Settings UI, the steps below cover the most common cases.

## What to reconfigure manually

### Theme and colors

1.  In the Warp app, open **Settings** > **Appearance** > **Themes**.
2.  Choose a built-in theme that matches your Ghostty setup, or [create a custom theme](/terminal/appearance/custom-themes/) by translating your Ghostty colors into a YAML theme file.
3.  If your Ghostty config references a custom theme, open the matching file in `~/.config/ghostty/themes/` and copy the foreground, background, and 16 ANSI color values.

### Font and text

1.  In the Warp app, open **Settings** > **Appearance** > **Text, fonts, & cursor** and match your Ghostty `font-family` and `font-size` values.
2.  If you use font ligatures, toggle **Ligatures** on.

### Keybindings

Warp’s [default keyboard shortcuts](/getting-started/keyboard-shortcuts/) cover most Ghostty bindings. For custom bindings from your Ghostty `keybind` lines, open **Settings** > **Keyboard shortcuts** in the Warp app and add them manually.

### Shell and prompt

Warp detects your login shell automatically. To override it, open **Settings** > **Features** > **Session** in the Warp app and choose a shell from **Startup shell for new sessions**.

For prompts, choose between Warp’s [native prompt](/terminal/appearance/prompt/#warp-prompt) (drag-and-drop context chips) or the [shell prompt (PS1)](/terminal/appearance/prompt/#custom-prompt) if you want to keep your existing prompt configuration.

### Quick terminal (Quake mode)

In the Warp app, configure Warp’s equivalent from **Settings** > **Features** > **Window** > **Global hotkey**. See [global hotkey](/terminal/windows/global-hotkey/) for the full configuration.

## Warp-native equivalents

Use this table to find the closest Warp equivalent for Ghostty features you might look for after switching:

| From Ghostty | In Warp |
| --- | --- |
| Quick terminal / dropdown window | [Global hotkey](/terminal/windows/global-hotkey/) |
| Native tabs and splits | [Tabs](/terminal/windows/tabs/), [vertical tabs](/terminal/windows/vertical-tabs/), [split panes](/terminal/windows/split-panes/) |
| Command palette | [Command Palette](/terminal/command-palette/) (`⌘+P` on macOS, `Ctrl+Shift+P` on Linux/Windows) |
| GPU-accelerated rendering | GPU-rendered natively on all supported platforms |
| Kitty graphics protocol | Image rendering for most common workflows (see [more features](/terminal/more-features/)) |
| Shaders and custom visual effects | Not supported; closest: [size, opacity, and blurring](/terminal/appearance/size-opacity-blurring/) + [pane dimming](/terminal/appearance/pane-dimming/) |

Beyond parity, Warp adds [Agent Mode](/agent-platform/local-agents/overview/), [Code Review](/code/code-review/), and [Warp Drive](/knowledge-and-collaboration/warp-drive/) for AI-assisted development and team collaboration.

For more on what you can configure, see [Customizing Warp](/getting-started/quickstart/customizing-warp/).