# Migrate to Warp from Ghostty

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 transfers automatically

Warp doesn't ship a Ghostty importer, but it can do most of the work for you agentically. Ghostty stores its configuration in a plain-text key-value file at `~/.config/ghostty/config`.

## 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](https://docs.warp.dev/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](https://docs.warp.dev/terminal/appearance/custom-themes).

1. In Warp, open a new tab and switch to [Agent Mode](https://docs.warp.dev/agent-platform/warp-agents) with `⌘+I` (macOS) or `Ctrl+I` (Linux/Windows).
2. Paste a prompt like:

   > 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 and approve. 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. Open **Settings** > **Appearance** > **Themes** in Warp.
2. Pick a built-in theme that matches your Ghostty setup, or [create a custom theme](https://docs.warp.dev/terminal/appearance/custom-themes) by translating your Ghostty colors into a YAML theme file.
3. Ghostty's theme files live in `~/.config/ghostty/themes/`. Open the file named in your Ghostty `theme` setting to copy the foreground, background, and 16 ANSI color values.

### Font and text

1. In **Settings** > **Appearance** > **Text, fonts, & cursor**, match your Ghostty `font-family` and `font-size` values.
2. If you use font ligatures, ensure **Ligatures** is enabled.

### Keybindings

Warp's [default keyboard shortcuts](https://docs.warp.dev/getting-started/keyboard-shortcuts) cover most Ghostty bindings. For custom bindings from your Ghostty `keybind` lines, open **Settings** > **Keyboard shortcuts** and add them manually.

### Shell and prompt

Warp detects your login shell automatically. To override it, go to **Settings** > **Features** > **Session** and pick a shell from **Startup shell for new sessions**.

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

### Quick terminal (Quake mode)

Configure Warp's equivalent via **Settings** > **Features** > **Window** > **Global hotkey**. See [global hotkey](https://docs.warp.dev/terminal/windows/global-hotkey) for the full configuration.

## Warp-native equivalents

Features Ghostty users commonly miss, and where they live in Warp:

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

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

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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.warp.dev/getting-started/migrate-to-warp/migrate-to-warp-from-ghostty.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.