1081 words
5 minutes
Migrating from Warp to Ghostty

With the rise of terminal-native AI tools like Claude Code and Cursor Agent, the terminal is no longer just a place to type commands — it’s now the primary development environment. A fast, lightweight, controllable terminal emulator matters more than ever.

ghostty-org
/
ghostty
Waiting for api.github.com...
00K
0K
0K
Waiting...

Why I Left Warp#

Warp is a modern terminal built in Rust, with AI assistance, block editing, and command search as its headline features. I used it for about a year and genuinely enjoyed the convenience, but as time went on, a few issues surfaced:

  • Heavy resource usage: GPU rendering plus a rich feature set adds up to noticeable memory and CPU overhead

Warp memory usage

  • Slow startup: a 2–3 second cold start that breaks my flow
  • Mandatory login: you can’t use it without an account. Why does a terminal need an account?
  • Bundled AI I never used: in practice I lean on Claude Code, so Warp’s built-in AI sat untouched
  • Closed source: no way to customize it or contribute back

Why Ghostty#

Ghostty is written in Zig by Mitchell Hashimoto, co-founder of HashiCorp. Its design philosophy happens to address every complaint I had about Warp:

  • Instant startup: GPU-accelerated rendering, ready in what feels like no time
  • Light on resources: roughly a third of Warp’s memory footprint

Ghostty memory usage

  • Fully open source: MIT licensed, with an active community
  • No account needed: works out of the box
  • Native feel: follows macOS design conventions
  • Simple configuration: one file, intuitive syntax

Installation#

Terminal window
brew install --cask ghostty

You can also download it directly from the official site.

Configuration#

Ghostty uses a single config file at ~/.config/ghostty/config:

Initialize the config
mkdir -p ~/.config/ghostty && touch ~/.config/ghostty/config
# Install the font used below
brew install --cask font-maple-mono-nf-cn

Here’s my full config:

~/.config/ghostty/config
# ========== Font ==========
# Main font: Maple Mono NF CN
font-family = Maple Mono NF CN
font-size = 14
# Line height (Maple Font officially recommends 1.8x; 30% worked best for me)
adjust-cell-height = 25%
# Enable Maple Mono ligatures and font features (the officially recommended set)
# calt: basic ligatures | zero: dotted zero | cv01: tighter spacing
# ss01: separated equals | ss02: separated comparison operators | ss07: forced >> ligature | ss08: double arrows
font-feature = calt, cv01, cv03, ss01, ss02, ss03
# Font weight (renders bolder, similar to Tabby's 600/700 setup)
font-thicken = true
# ========== Theme ==========
theme = GitHub Dark Dimmed
# ========== Window size ==========
# Initial window size, in character cells
window-width = 125
window-height = 35
# Remember window position and size
window-save-state = always
# ========== Cursor ==========
# Cursor style: block (a thick block cursor, similar to Tabby)
cursor-style = bar
# Cursor blink
cursor-style-blink = true
# Cursor color (bright orange, easier to spot)
cursor-color = #ff9e64
# Text color under the cursor
cursor-text = #1a1b26
# ========== Window appearance ==========
# Window padding
window-padding-x = 8
window-padding-y = 8
# Window decoration style (macOS) — the tabs style enables the tab bar
macos-titlebar-style = tabs
# Keep the window shadow
macos-window-shadow = true
# ========== Other tweaks ==========
# Slightly transparent background (optional; 1.0 is fully opaque)
background-opacity = 0.97
# Scrollback buffer size in bytes
# Plenty of room for long-running sessions like Claude Code
scrollback-limit = 200000000
# Hide the mouse while typing
mouse-hide-while-typing = true
# ========== Shell Integration ==========
# Enable shell integration, but explicitly disable the cursor feature so it doesn't override our cursor settings
shell-integration = zsh
shell-integration-features = no-cursor,title
keybind = shift+enter=text:\x1b\r
keybind = ctrl+enter=text:\\\r

Themes#

Ghostty ships with a large theme collection:

List available themes
ghostty +list-themes
Popular themes
theme = tokyonight
theme = catppuccin-mocha
theme = dracula
theme = nord
theme = GitHub Dark Dimmed # the one I use

Custom themes live in ~/.config/ghostty/themes/.

Migration Adjustments#

Warp works out of the box; Ghostty expects you to configure it yourself. The flip side is far more control.

Command-Line Enhancements#

Warp bundles history autosuggestions and syntax highlighting. In Ghostty, you get those from zsh plugins:

Install zsh plugins
brew install zsh-autosuggestions zsh-syntax-highlighting zsh-completions

Add the following to ~/.zshrc:

~/.zshrc
# -----------------------
# Homebrew Zsh completions (must be BEFORE oh-my-zsh / compinit)
# -----------------------
if type brew &>/dev/null; then
export BREW_PREFIX="$(brew --prefix)"
FPATH="$BREW_PREFIX/share/zsh-completions:$FPATH"
FPATH="$BREW_PREFIX/share/zsh/site-functions:$FPATH"
fi
# -----------------------
# Zsh plugins (Homebrew)
# -----------------------
# zsh-autosuggestions - suggests commands from history (gray hint text)
if [[ -n "$BREW_PREFIX" && -f "$BREW_PREFIX/share/zsh-autosuggestions/zsh-autosuggestions.zsh" ]]; then
source "$BREW_PREFIX/share/zsh-autosuggestions/zsh-autosuggestions.zsh"
fi
# zsh-syntax-highlighting - command syntax highlighting (must be sourced last)
if [[ -n "$BREW_PREFIX" && -f "$BREW_PREFIX/share/zsh-syntax-highlighting/zsh-syntax-highlighting.zsh" ]]; then
source "$BREW_PREFIX/share/zsh-syntax-highlighting/zsh-syntax-highlighting.zsh"
fi
NOTE

If you use Oh My Zsh, do not add zsh-autosuggestions and zsh-syntax-highlighting to plugins=() — they would be double-loaded alongside the Homebrew versions.

What each plugin gives you:

  • zsh-autosuggestions: suggestions from history (accept with →)
  • zsh-syntax-highlighting: syntax highlighting; bad commands turn red
  • zsh-completions: enhanced Tab completion

Prompt Theme: Spaceship#

Warp ships a polished prompt. In Ghostty you can get a similar look with Spaceship.

1. Install Oh My Zsh (prerequisite)#

Spaceship rides on the Oh My Zsh framework, so install that first:

Install Oh My Zsh
sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"
WARNING

The installer backs up your existing ~/.zshrc to ~/.zshrc.pre-oh-my-zsh and generates a fresh one. Afterwards, migrate your old settings into the new file by hand.

2. Install the Spaceship theme#

Clone Spaceship into the Oh My Zsh themes directory
git clone https://github.com/spaceship-prompt/spaceship-prompt.git \
"${ZSH_CUSTOM:-$HOME/.oh-my-zsh/custom}/themes/spaceship-prompt" --depth=1
# Create the symlink
ln -sf \
"${ZSH_CUSTOM:-$HOME/.oh-my-zsh/custom}/themes/spaceship-prompt/spaceship.zsh-theme" \
"${ZSH_CUSTOM:-$HOME/.oh-my-zsh/custom}/themes/spaceship.zsh-theme"

3. Enable the theme#

Oh My Zsh generates ~/.zshrc for you; find the ZSH_THEME line and change it to:

~/.zshrc
export ZSH="$HOME/.oh-my-zsh"
ZSH_THEME="spaceship"
source "$ZSH/oh-my-zsh.sh"

Spaceship shows your Git branch, Node version, command duration, and other context — very handy for day-to-day development.

History Search: Atuin#

Warp’s history popup is convenient; Atuin is an even more powerful replacement:

Install Atuin
brew install atuin
# Initialize (add to ~/.zshrc)
eval "$(atuin init zsh)"
# Import existing shell history
atuin import auto

Atuin’s config lives at ~/.config/atuin/config.toml; here’s mine:

~/.config/atuin/config.toml
# Scope for the ↑ key: global (all directories/sessions/hosts)
filter_mode_shell_up_key_binding = "global"
# Search mode for the ↑ key: prefix matching (nice for ssh, git, and the like)
search_mode_shell_up_key_binding = "prefix"
# Compact style
style = "compact"
# Inline height in rows
inline_height = 14
# Disable the long-command preview
show_preview = false
# Hide the help line and tabs for a cleaner UI
show_help = false
show_tabs = false
# Enter runs the command immediately (Tab to edit)
enter_accept = true
[sync]
# Enable sync v2
records = true
TIP

Once configured, pressing ↑ opens the history list; type a keyword to filter instantly.

Where Atuin shines:

  • Full-text search: Ctrl+R opens an interactive search
  • Cross-device sync: optional cloud sync
  • Usage stats: see which commands you run most
  • Context-aware: filter by directory or session

Atuin UI

Comparison#

AspectWarpGhostty
Startup speed2–3 s< 0.5 s
Memory usage~600 MB~100 MB
Open source❌✅
Requires account✅❌
Built-in AI✅❌
Block editing✅❌
CustomizabilityMediumHigh

Keyboard Shortcuts#

ActionShortcut
Split horizontallyCmd+D
Split verticallyCmd+Shift+D
Switch panesCmd+[ / Cmd+]
Close paneCmd+W
Open configCmd+Shift+,
TIP

Ghostty reloads the config automatically whenever the file changes — no restart needed.

Conclusion#

Warp is a car with autopilot; Ghostty is a stick shift.

More effort, but I finally know exactly who’s responsible for every action.

Migrating from Warp to Ghostty
https://www.mihouo.com/en/posts/tool-share/from-warp-to-ghostty/
Author
Jia
Published at
2025-12-26
License
CC BY-NC-SA 4.0