Terminal Ghostty: La Guía Completa de Configuración para Mac (2026)

El terminal Ghostty es un emulador de terminal moderno, acelerado por GPU, que se siente nativo en macOS, se instala con un comando, y se configura con un archivo de texto plano. También es la implementación de referencia de libghostty, el motor de renderizado que ahora impulsa cmux y más de 130 proyectos. Si pasas tu día en un Mac dentro de una terminal, esta es la guía de configuración que te daría.

En esta guía vas a:

Si quieres específicamente Starship + Ghostty con presets y un montaje completo de prompt, mira mi guía compañera: Starship + Ghostty: Turbocharge Your Mac Terminal Setup.

Estado a octubre de 2026: la versión actual es 1.3.1, la 1.4.0 llega a finales de octubre de 2026, y el desarrollo salió de GitHub en abril de 2026 (queda un espejo de solo lectura ahí). Detalles en la sección de estado de abajo.

Funciones clave de Ghostty

Aceleración GPU

Ghostty renderiza usando tu GPU, lo que significa scroll rápido y rendimiento suave. La salida de terminal compleja se mantiene responsive, y trabajar con archivos grandes no frena las cosas.

UI nativa

Ghostty no intenta ser una UI que sirva para todo. En macOS usa Swift, SwiftUI y AppKit nativos. En Linux usa GTK4. Se enchufa al sistema correctamente: soporte de AppleScript y Shortcuts en el Mac, integración con systemd en Linux (aislamiento cgroup, instancia única). Ghostty se siente parte de tu sistema en vez de una herramienta ajena.

Archivo de configuración simple (clave-valor)

La config es directa: ~/.config/ghostty/config usa pares clave-valor simples. Sin lenguaje de scripting, sin sintaxis compleja. Cambia fuentes, elige un tema, ajusta la opacidad. Recorrido completo en la sección de configuración del archivo config de abajo.

Multiplexor integrado

Ghostty tiene multiplexación integrada para que puedas dividir paneles y gestionar múltiples sesiones sin echar mano de tmux. Si quieres llevar esa idea más lejos para flujos de trabajo IA con notificaciones de agentes, espacios de trabajo verticales y un navegador integrado, mira mi guía de cmux Terminal: A Practical Guide for AI Coding Agents on macOS.

Soporte de color rico

Soporta true color y viene con más de 100 temas integrados. También puedes añadir personalizados si prefieres algo específico.

Soporte de imágenes

Ghostty soporta el Kitty Graphics Protocol, así que puedes renderizar imágenes directamente en la terminal. Útil si trabajas con herramientas de vista previa o quieres salida visual en línea. Los frames de imagen animados están en el milestone 1.4, así que eso viene, no está lanzado.

Qué hay de nuevo en Ghostty (estado octubre 2026)

La versión actual es 1.3.1. Ghostty 1.3.0 salió el 9 de marzo de 2026 tras 6 meses de trabajo: 180 colaboradores, 2.858 commits. Funciones principales de 1.3:

• Búsqueda en scrollback: Cmd+F en macOS o Ctrl+Shift+F en GTK busca en tu historial de terminal. Todas las coincidencias se resaltan; salta entre ellas con Cmd+G / Shift+Cmd+G o las flechas. En macOS la barra de búsqueda se puede arrastrar a cualquier esquina.
• Barras de scroll nativas: se ven y comportan como espera tu SO, aparecen durante el scroll, y se desvanecen en reposo.
• Clic para mover el cursor: si tu shell soporta detección de prompt OSC 133, puedes hacer clic para posicionar el cursor en tu prompt. Funciona con zsh, fish y bash con el montaje de prompt adecuado.
• Overlay de teclas para leader keys: aparece un overlay visual tras pulsar una leader key mostrando los bindings disponibles. Útil si usas keybindings personalizados o teclas de prefijo de tmux.
• Auto-actualización en macOS: Ghostty puede actualizarse a sí mismo sin necesitar Homebrew ni una descarga manual.
• Mejoras de text shaping: mejor manejo de scripts complejos (árabe, devanagari, tailandés) y ligaduras.

1.3.1 (13 de marzo de 2026) fue una versión parche que arregló eventos fantasma de ratón, selección y scroll en macOS tras cambios de foco. También añadió progress-style (controlar o desactivar barras de progreso OSC 9;4), acciones de keybind set_surface_title y set_tab_title, expansión de ~/ en working-directory, y manejo multilínea en jump_to_prompt:next.

Corrección de seguridad que merece acción

CVE-2026-26982 parcheó un problema donde caracteres de control (como 0x03, Ctrl+C) en texto pegado o arrastrado-y-soltado podían ejecutar comandos arbitrarios. Publicado el 10 de marzo de 2026 en el NVD. Si sigues en cualquier cosa anterior a 1.3.1, actualiza ahora:

brew upgrade --cask ghostty

Cronología de Ghostty 1.4.0

Ghostty 1.4.0 llega el 23 de octubre de 2026 (el milestone mostraba 1.220 issues cerrados a mediados de octubre de 2026; 1.5.0 está milestoned para el 31 de marzo de 2027). La cadencia de releases de 6 meses se mantiene; simplemente se pasó de la estimación original de septiembre.

Candidatos visibles en el milestone:

• Frames de animación de Kitty Graphics
• Mover una pestaña a una ventana nueva
• GTK: reordenar splits arrastrando y soltando
• copy-on-select y middle-click-action más flexibles
• Capacidad de nombrar o renombrar una ventana
• Desenfoque de fondo GTK/Wayland vía ext-background-effects-v1
• Cambio en runtime de max_scrollback (el que vigilar si haces scripting contra él)
• Migración a Zig 0.16 (interna, pero sube los requisitos para compilar desde fuente)

Ghostty salió de GitHub en abril de 2026

El 28 de abril de 2026 Hashimoto anunció que Ghostty dejaba GitHub por caídas crónicas, diciendo que había estado incapaz de hacer review de PRs durante horas durante una caída de GitHub Actions y que “this is no longer a place for serious work.” La URL de GitHub sigue funcionando como espejo de solo lectura sincronizado a diario (todavía unas 62k estrellas), pero ya no es donde ocurre el desarrollo.

El impacto para el lector es pequeño pero real: no abras nuevos issues en GitHub. Reporta bugs a través de ghostty.org o el Discord del proyecto. CONTRIBUTING.md ahora incluye un sistema de vouch para colaboradores primerizos y una política estricta de uso de IA (“you must understand your code… no agent-generated slop”). Buena política.

Mientras tanto, la nueva empresa de Hashimoto, Superlogical (anunciada el 29 de julio de 2026), está construyendo un multiplexor de terminal sobre libghostty. El propio Ghostty se queda con la organización sin ánimo de lucro a la que se donó en diciembre de 2025. Cubrí los planes del multiplexor en Superlogical Rex, el nuevo multiplexor de terminal del creador de Ghostty. La app de macOS sigue viendo alrededor de un millón de descargas a la semana (Hashimoto, 2026).

Rendimiento

Ghostty está escrito en Zig, y se nota. La comparación honesta viene del README del proyecto: Ghostty y Alacritty suelen estar dentro de unos pocos puntos porcentuales el uno del otro, y ambos son aproximadamente 100x más rápidos que Terminal.app e iTerm en cargas de salida grande. Ese es el techo de lo que afirmaría de cualquier benchmark.

Las diferencias del mundo real son más pequeñas de lo que sugieren los números. Tu fuente, shaders, opacidad y la carga real importan más que una cifra en ms de un test de volcado Unicode. Si quieres una alternativa lado a lado en el Mac, mira mi guía de WezTerm on Mac with tmux, zoxide, and Starship.

Funciones únicas

Terminal Inspector

El Terminal Inspector es una de las mejores funciones de Ghostty. Ábrelo con Cmd+Option+I y obtienes información de depuración en tiempo real: pulsaciones de teclas, tiempos de render, todo lo que pasa bajo el capó. Útil cuando estás depurando un keybind o un problema de renderizado en vez de adivinar.

Shaders

Puedes escribir shaders personalizados para aplicar efectos visuales: glow, filtros CRT, lo que quieras probar. Divertido si te gusta retocar cosas visualmente, y un buen ejemplo de cuánto del pipeline de renderizado está expuesto.

El ecosistema libghostty: el motor detrás de las apps

Diagrama del ecosistema libghostty: el motor libghostty en el centro impulsando la GUI de Ghostty, cmux, clientes SSH, terminales embebidas, ports a plataformas y herramientas de producción

Todo lo de arriba describe Ghostty la app. Desde finales de 2025 hay una segunda historia, posiblemente más grande: libghostty. Es la librería multiplataforma compatible con C-ABI (escrita en Zig) que impulsa el propio Ghostty: emulación de terminal, manejo de fuentes y renderizado. Cualquier aplicación puede embeberla. Piensa en ella como WebKit para terminales: la GUI de Ghostty es solo un consumidor del motor.

Mitchell Hashimoto anunció libghostty en septiembre de 2025, empezando con libghostty-vt, una librería sin dependencias que parsea secuencias de terminal y mantiene el estado del terminal. El ecosistema creció rápido después de eso.

La lista awesome-libghostty sigue 137 proyectos construidos sobre el motor. Los más interesantes:

También hay bindings para Rust, Go, .NET, Python, TypeScript, React Native/Expo, Flutter/Dart, Elixir, Odin, C++, MoonBit y HarmonyOS. Construir un terminal personalizado es ahora un proyecto de fin de semana en vez de uno de varios años.

Esa salvedad no ha impedido la adopción en producción más allá de las terminales: Turborepo de Vercel y bombadil de Antithesis embeben libghostty (nombrados por Hashimoto como consumidores con impacto). Esos no son juguetes de fin de semana.

Qué significa esto para tu configuración

Tu config de Ghostty es portable. cmux, de lejos la app libghostty más popular (28k+ estrellas en GitHub), lee tu ~/.config/ghostty/config existente para temas, fuentes y colores. Obtienes una app completamente diferente con cero reconfiguración. Recorrido completo aquí: cmux Terminal: A Practical Guide for AI Coding Agents on macOS.

Más importante aún, las terminales ya no están forzadas a ser genéricas. Mantén Ghostty como tu driver diario y corre una app especializada (un espacio de trabajo de agentes, un cliente SSH, una terminal embebida) cuando el trabajo lo pida, sin reaprender rarezas de renderizado, sintaxis de config o fuentes. Cada app libghostty hereda la misma corrección y rendimiento.

Lectura adicional: ghostty.org/docs/about · anuncio de libghostty · awesome-libghostty

Las notificaciones de agentes están consiguiendo un protocolo (OSC 7501)

Si corres agentes de codificación IA en tu terminal, conoces el problema: el agente se bloquea esperando permiso o input, y nada te avisa. Vuelves a la pestaña, lees el prompt, actúas, te vas. Repite.

Hoy, las herramientas detectan ese estado de dos formas frágiles:

1. Heurística de screen-scraping. Inboxes agénticos como Herdr llevan manifiestos de detección TOML que hacen pattern-match sobre títulos de ventana y salida. Esos manifiestos necesitaron 10 cambios en 3 meses solo para seguir el ritmo de los patrones de título de Claude Code.
2. APIs de socket por app. cmux notify y la API de socket de Herdr funcionan, pero un socket no atraviesa SSH ni entra en un contenedor. En el momento en que tu agente corre en una máquina remota, la ruta de notificación se rompe.

El 6 de octubre de 2026 Hashimoto publicó el OSC 7501 Program Status Protocol como arreglo genérico. Cualquier programa reporta su estado a través del PTY usando una secuencia de escape estándar: idle, working, blocked (con una razón), finished o failed. La forma del payload es:

state=blocked:kind=permission:app=terraform:msg=<base64>

Los terminales e inboxes agénticos (el anuncio nombra Herdr, cmux y Agent Deck) lo renderizan como quieran: un anillo de notificación, un badge, un push al teléfono.

Flujo OSC 7501: un agente de codificación reporta un estado bloqueado a través del PTY, recibido por un terminal o inbox agéntico

Por qué importa: un protocolo real significa que el estado del agente funciona sobre SSH, dentro de contenedores y entre máquinas. El tooling de agentes deja de depender del scraping de títulos de prompt. Si quieres empujar más las notificaciones de agentes hoy, mira plugins de Herdr que detectan estado de agentes, o controla agentes IA desde tu teléfono con Moshi + Herdr. Los terminales y los agentes de codificación (Claude Code, Codex CLI, opciones open-source como OpenCode Go) se mueven todos en esta dirección.

Spec: program-status OSC 7501 · Rex docs

Configuración del terminal Ghostty: instalación y setup

Si te interesa ver algunas apps Mac gratuitas y chulas puedes mirar la sección de apps Mac de toolhunt.net.

Prerequisitos

Nota de costes: Ghostty es gratis y con licencia MIT. Sin cuenta, sin clave de licencia, sin telemetría.

Si corres Nix en una distro que no es NixOS, ten en cuenta que Ghostty necesita configuración extra de drivers OpenGL o no arrancará (mira la sección de resolución de problemas).

Quickstart (TL;DR)

Montaje rápido si solo quieres Ghostty corriendo:

brew install --cask ghostty
brew install font-meslo-lg-nerd-font
mkdir -p ~/.config/ghostty

Luego crea ~/.config/ghostty/config con la config básica de abajo y reinicia Ghostty. Verifica la versión: ghostty --version (o Ghostty → About en la barra de menú). Quieres 1.3.1 o más nuevo.

Instala Ghostty en Mac

brew install --cask ghostty

Verifica la instalación antes de culpar a tu config:

ghostty --version

Quieres 1.3.1 o más nuevo (esa es la versión con la corrección del CVE de texto pegado). Luego abre una pestaña nueva con Cmd+T para confirmar que la ventana renderiza. Si el cask da error con “already an app at /Applications”, mira la sección de resolución de problemas.

Los builds de macOS también se auto-actualizan dentro de la app, así que no necesitas cuidar Homebrew para versiones de parche.

Ghostty en Linux

Los docs oficiales confirman un repositorio de paquetes a partir de Ubuntu 26.04:

sudo apt install ghostty

Revisa los docs para arquitecturas actuales y detalles del paquete. En Linux, Ghostty necesita GTK 4.14 y Adwaita 1.5 como mínimo (el proyecto sigue los mínimos de Debian/Fedora/Ubuntu LTS). Si la inicialización de GPU falla en hardware viejo, mira los docs de Linux para opciones de renderizado por software en vez de adivinar variables de entorno.

Si compilas desde fuente, ojo: el milestone 1.4 incluye una migración a Zig 0.16, que subirá el requisito de toolchain cuando aterrice.

Instala la Nerd Font Meslo

Las Nerd Fonts incluyen iconos y símbolos de programación. Instala Meslo LG vía Homebrew:

brew install font-meslo-lg-nerd-font

La fuente se instala automáticamente. Verifícala en Font Book si hace falta. Puede que necesites reiniciar Ghostty tras la instalación.

Si los iconos se renderizan como cajas o signos de interrogación, Ghostty no está usando la Nerd Font: tu valor font-family debe coincidir exactamente con la salida de ghostty +list-fonts.

Configuración del archivo config de Ghostty

Crea el archivo de config y añade ajustes básicos:

mkdir -p ~/.config/ghostty
vim ~/.config/ghostty/config

Añade esto a la config:

font-family = MesloLGS Nerd Font Mono
font-size = 18
background-opacity = 0.9
theme = Argonaut

Encuentra fuentes y temas disponibles:

ghostty +list-fonts
ghostty +list-themes

Verifica: tras la recarga, el tema y la opacidad deberían cambiar inmediatamente. Si no, la ruta de config está mal (debe vivir en ~/.config/ghostty/config) o un nombre de clave está mal escrito.

Consejo: Mantén tu config de Ghostty mínima. Pon la personalización pesada en tus archivos rc del shell o montaje de prompt en su lugar. Esto hace más fácil sincronizar entre máquinas.

Más ajustes que merecen probarse

La config básica te pone en marcha. Estas opciones cubren los retoques más pedidos:

Atajos esenciales (defaults de macOS)

Todos estos son rebindeables con líneas keybind. Ejecuta ghostty +list-keybinds --default para ver tus defaults actuales.

Opciones de prompt (elige una)

Ahora necesitas un prompt. Elige una:

• Starship funciona con cualquier shell, tiene temas listos, y es rápido. Tengo una guía completa para Starship + Ghostty: Starship + Ghostty: Turbocharge Your Mac Terminal Setup.
• Powerlevel10k está construido para zsh y es muy configurable, que es por lo que los usuarios de zsh lo siguen eligiendo.

Si vas por la ruta zsh, también merece la pena rebuscar entre los mejores plugins de Oh My ZSH para 2026 para completados y detalles de calidad de vida.

Instala el tema powerlevel10k

Instala Powerlevel10k:

brew install powerlevel10k
echo "source $(brew --prefix)/share/powerlevel10k/powerlevel10k.zsh-theme" >> ~/.zshrc
source ~/.zshrc

La primera ejecución muestra un asistente de configuración. Recórrelo para personalizar tu prompt: qué segmentos mostrar, colores, iconos, etc. Siempre puedes rejecutar p10k configure después para retocarlo.

El prompt muestra estado de git y tiempo de ejecución de comandos sin frenar. Edita ~/.p10k.zsh si quieres afinarlo más.

Configura el plugin zsh-autosuggestions

zsh-autosuggestions sugiere comandos mientras escribes, basándose en tu historial. Ponlo a funcionar:

brew install zsh-autosuggestions
echo "source $(brew --prefix)/share/zsh-autosuggestions/zsh-autosuggestions.zsh" >> ~/.zshrc
source ~/.zshrc

Ahora cuando escribes, verás sugerencias atenuadas. Pulsa la flecha derecha o Fin para aceptarlas. Verifica: escribe el inicio de un comando que ejecutaste recientemente y la sugerencia debería aparecer inmediatamente. Puedes personalizar las sugerencias en .zshrc: cambiar colores, retocar keybindings, etc.

Ver también: Enable Command Autocomplete in Zsh

Configura zsh-syntax-highlighting

zsh-syntax-highlighting colorea tus comandos mientras escribes: verde para comandos válidos, rojo para errores. Instálalo:

brew install zsh-syntax-highlighting
echo "source $(brew --prefix)/share/zsh-syntax-highlighting/zsh-syntax-highlighting.zsh" >> ~/.zshrc
source ~/.zshrc

Resalta comandos y opciones válidos, subraya rutas de archivo existentes y empareja pares de corchetes. Atrapa erratas antes de pulsar enter. Verifica: ejecuta ls (verde) luego lss (rojo) tras source ~/.zshrc.

Ver también: Enable Syntax Highlighting in Zsh

Mejora Ghostty con tmux y zoxide

Ghostty tiene multiplexación integrada, pero tmux merece añadirse si necesitas:

• Flujos de attach/detach remotos sobre SSH
• Compartición de sesiones entre máquinas o equipos
• Un ecosistema y documentación más grandes

Una cosa a vigilar: la empresa de Hashimoto, Superlogical, está construyendo un multiplexor de terminal propio sobre libghostty, que será la ruta de actualización natural para persistencia de sesión sin tmux. Cubierto en Superlogical Rex, el nuevo multiplexor de terminal del creador de Ghostty. Hasta que salga, tmux sigue siendo la opción aburrida y fiable.

Si tu flujo de trabajo es más local y centrado en agentes que remoto, cmux es otra ruta que merece un vistazo.

zoxide hace más rápido saltar entre directorios.

Qué es tmux y cómo puede ayudar

tmux te deja gestionar múltiples sesiones de terminal en una ventana. Útil para correr procesos en segundo plano, compartir sesiones con otros, o mantener tu montaje entre reinicios.

brew install tmux

Luego simplemente escribe tmux para empezar una sesión nueva. Más detalles: install tmux on macOS and learn the essential commands

Si quieres una máquina remota a la que hacer attach, un Hetzner Cloud VPS empieza en unos pocos euros al mes (orden de magnitud: 4-5 EUR/mes por una VM pequeña).

Qué es zoxide y cómo puede ayudar

zoxide reemplaza cd con navegación más inteligente. Sigue tus directorios más usados para que puedas saltar a ellos rápido con coincidencia difusa.

brew install zoxide
echo 'eval "$(zoxide init zsh)"' >> ~/.zshrc
source ~/.zshrc

Ahora usa z en vez de cd para moverte. Ver: Zoxide tutorial: smarter terminal navigation

Con tmux, zoxide y Ghostty juntos, tienes un flujo de trabajo de terminal sólido: multiplexación, navegación rápida y renderizado impulsado por GPU.

Errores conocidos de Ghostty

‘xterm-ghostty’: unknown terminal type

En algunas máquinas Linux remotas, las herramientas pueden no reconocer el tipo de terminal de Ghostty y puedes ver errores como: 'xterm-ghostty': unknown terminal type.

Arreglo rápido para la sesión actual:

export TERM=xterm-256color

Arreglo permanente en esa máquina:

echo "export TERM=xterm-256color" >> ~/.bashrc
source ~/.bashrc

Si solo pasa sobre SSH, establece TERM condicionalmente en tu config del shell en su lugar.

Los iconos se renderizan como cajas

La Nerd Font no está activa. Comprueba que font-family en ~/.config/ghostty/config coincide exactamente con la salida de ghostty +list-fonts, luego reinicia Ghostty. Instalar la fuente no basta si la config sigue apuntando a un nombre de familia diferente.

Los cambios de config no se aplican

Tres sospechosos habituales: ruta equivocada (debe ser ~/.config/ghostty/config), un nombre de clave con errata (ignorado silenciosamente), u olvidaste recargar con Cmd+Shift+,. Cambia algo obvio como theme primero para probar que la ruta de recarga funciona.

Conflictos del cask de Homebrew

Si brew install --cask ghostty da error con “already an app at /Applications”, tienes una copia manual en medio. Borra /Applications/Ghostty.app, luego ejecuta la instalación del cask de nuevo.

Ghostty no arranca en Nix (no-NixOS)

Necesitas configuración extra de drivers OpenGL para que las librerías del Nix store encuentren tus drivers de GPU. Mira los docs oficiales de instalación para el workaround actual.

Rollback / deshacer

Un terminal es de bajo riesgo para eliminar. Desmontaje completo:

brew uninstall --cask ghostty
rm -rf ~/.config/ghostty

Luego borra la Nerd Font Meslo de Font Book si quieres que desaparezca. Tus cambios en los rc del shell (powerlevel10k, plugins de zsh, zoxide) son independientes; revierte esas líneas en ~/.zshrc una por una.

FAQ

Conclusión

El renderizado GPU, la UI nativa y el Terminal Inspector ponen a Ghostty por delante de la mayoría de terminales en el Mac ahora mismo. El cambio más grande es libghostty: apps especializadas para agentes, SSH y uso embebido corren todas sobre el mismo motor y leen la misma config. Ghostty 1.4.0 llega a finales de octubre de 2026, y la predicción de Hashimoto se mantiene: para mediados de 2027 más gente usará Ghostty a través de apps libghostty que la GUI misma.

Si pasas tiempo en la terminal, instálalo y mira cómo se siente. Y si corres agentes de codificación IA, vigila cmux y el protocolo OSC 7501, porque los terminales conscientes de agentes están a punto de volverse mucho menos molestos.

Ghostty también funciona genial con Fish Shell. Si buscas una mejora de shell, mira mi comparación Fish Shell vs Bash vs Zsh, la guía de configuración de Fish Shell en macOS, o configura el prompt Starship con Fish.