Fundierte Artikel über Technologien, die das Kommende formen.

Libghostty 1.0: Lehren aus einem stabilen C-ABI-Design

Libghostty 1.0 zeigt, wie ein stabiles C-ABI gelingt: opake Handles, enum-basierte Setter, CI-geprüfte Symbolversionen und Library-first-Design.

Illustration eines gemeinsamen, leuchtenden Kerns, der viele verschiedene terminalartige Bildschirme antreibt, verbunden durch Lichtfäden.
Ein Emulationskern, viele Gesichter: libghostty steckt inzwischen in IDEs, Editoren, TUIs und neuen Terminals gleichermaßen.

Stell dir vor, du bist im Team, das das Terminal in den JetBrains-IDEs verantwortet. Dein Emulator, JediTerm, hat einen Bug, die Sorte, auf die Terminal-Emulatoren spezialisiert sind: Eine obskure Escape-Sequenz wird falsch dargestellt, und das ist zum Verrücktwerden schwer zu reproduzieren. Du könntest ihn patchen. Oder du löschst ein Jahrzehnt angesammelten Emulationscode und bindest eine C-Bibliothek mit stabilem ABI ein, die jemand anderes pflegt, fuzzt und für dich auf neun Betriebssysteme portiert. JetBrains hat die zweite Option gewählt. Jeder IntelliJ-, PyCharm- und GoLand-Nutzer, über 12,5 Millionen aktive Nutzer laut JetBrains selbst, betreibt jetzt ein Terminal, das von libghostty angetrieben wird, das diese Woche die Version 1.0 erreicht hat.

Das ist die Schlagzeile, aber die spannendere Geschichte steckt darunter. Libghostty ist der Terminal-Emulationskern, der aus Ghostty herausgelöst wurde, Mitchell Hashimotos GPU-beschleunigtem Terminal, und als eigenständige C-Bibliothek mit erzwungener ABI-Stabilitätsrichtlinie veröffentlicht wurde. Vor einem Jahr hatte sie keine C-API und genau einen Konsumenten. Heute gibt es ein getaggtes 1.0, verteilungsfertige Pakete und eine Liste von Adoptern, die wie das Who's who der Entwicklerwerkzeuge klingt. Wie man von „App mit Innenleben“ zu „Bibliothek, der die Branche vertraut“ kommt, ist eine Lektion in Ingenieursdisziplin, die weit über Terminals hinaus gilt.

Von der App zur Bibliothek: So wurde libghostty herausgelöst

Terminal-Emulation ist eines dieser Problemfelder, die aus der Ferne einfach aussehen und aus der Nähe still und leise brutal sind. Jahrzehnte an Escape-Sequenzen, konkurrierende Grafikprotokolle, Unicode-Grapheme-Clustering, Scrollback-Reflow beim Größenwechsel: Jeder Terminal-Autor entdeckt dasselbe Minenfeld erneut. Ich habe schon früher geschrieben, wie moderne GPU-beschleunigte Terminals funktionieren, vom TTY-Parsing bis zu Glyph-Atlanten, und das durchgehende Thema ist: Die Emulationsschicht ist der Ort, an dem Korrektheit zu Grunde geht. Genau diese Art von Code will man einmal schreiben, bis zum Umfallen testen und dann teilen.

Der Autor von Ghostty scheint das von Anfang an verstanden zu haben. Die Anwendung wurde in Zig gebaut, und ihr Emulationskern war so strukturiert, dass er sich abtrennen lässt: zuerst als Zig-Modul, dann hinter einer C-API, und jetzt als libghostty-vt 1.0 mit eigenem Release-Zyklus, eigenen Tarballs und eigenen Konsumenten. Die Extraktion war kein nachträglicher Einfall und keine Marketing-Geste. Das Projekt kündigte die Absicht über ein Jahr vor der C-API an und verbrachte dieses Jahr damit, die Grenze real zu machen. Die Reihenfolge zählt: Die Bibliothek wurde nicht zur 1.0 befördert, als der Code funktionierte, sondern als der Vertrag um den Code stabil genug war, um Zusagen darauf zu machen.

Die Liste der Konsumenten deutet darauf hin, dass sich die Wette gelohnt hat. Neovim hat einen genehmigten Pull Request, der libvterm durch libghostty-vt ersetzt, eine Änderung, die ein zehn Jahre altes Issue zum Scrollback-Reflow beim Größenwechsel schließt. Das zeigt, wie lange solche Wunden offen bleiben, wenn jedes Projekt seinen eigenen Emulator pflegt. KDE-Entwickler prototypen einen Konsole-Nachfolger darauf. Vercels Turborepo nutzt es, um Task-Ausgaben darzustellen. Antithesis hat es verwendet, um TUI-Programme zu fuzzen, und dabei echte Bugs in btop gefunden. Jemand hat darauf ein Emacs-Terminal gebaut, und es gibt einen WebAssembly-Build mit einer xterm.js-kompatiblen API. Community-Bindings existieren für Rust, Go, JavaScript, Swift, Python, .NET, Elixir, Dart und Java.

Ein stabiles C-ABI entwerfen: Opake Handles und Enum-Schlüssel

Hier ist der Teil, den du dir für deine eigenen Projekte abschauen solltest. Die meisten C-Bibliotheken scheitern an ihrer Langlebigkeit nicht, weil der Code verrottet, sondern weil das ABI verkalkt: Ein Struct bekommt ein Feld, und jeder Konsument muss neu kompiliert werden; eine Funktionssignatur ändert sich, und Symbole verschwinden; ein Enum wächst und verschiebt Werte. Das Design von libghostty ist eine kurze Meisterklasse darin, alle drei zu vermeiden, und die Techniken sind alt, bewährt und chronisch untergenutzt.

/* The clunky way: the struct IS the ABI.
* Add a field and every consumer recompiles or corrupts memory. */
typedef struct {
int rows;
int cols;
int scrollback_limit;
/* ... forty more fields your ABI now depends on forever */
} term_config_t;
/* The libghostty way: an opaque handle plus enum-keyed access.
* The library can add a hundred new settings without one new symbol. */
typedef struct ghostty_terminal_s ghostty_terminal_t;
typedef enum {
GHOSTTY_TERMINAL_ROWS,
GHOSTTY_TERMINAL_COLS,
GHOSTTY_TERMINAL_SCROLLBACK_LIMIT,
/* new keys append here, forever */
} ghostty_terminal_key_t;
ghostty_result_t ghostty_terminal_get(
const ghostty_terminal_t *terminal,
ghostty_terminal_key_t key,
void *out);
ghostty_result_t ghostty_terminal_set(
ghostty_terminal_t *terminal,
ghostty_terminal_key_t key,
const void *value);

Drei Entscheidungen tragen die Hauptlast. Erstens ist jedes Objekt ein opaker Handle: Aufrufer halten Zeiger, nie Structs, sodass die Bibliothek ihre Interna zwischen Releases frei umbauen kann. Zweitens liegen die Hunderten lesbaren und schreibbaren Werte hinter einer kleinen Menge enum-basierter Getter und Setter. Neue Funktionalität bedeutet eine neue Enum-Konstante, kein neues exportiertes Symbol. Und ein Programm, das gegen neuere Header gebaut wurde, aber gegen eine ältere Bibliothek läuft, bekommt ein sauberes Ergebnis GHOSTTY_UNSUPPORTED statt eines Absturzes oder stiller Datenmüll. Dieses eine Detail ist der Unterschied zwischen eleganter Degradierung und einem Segfault um 3 Uhr nachts im Produkt von jemand anderem.

Drittens tragen die wenigen Structs, die tatsächlich öffentlich sind, ihre eigene Größe oder reservieren Padding, sodass Felder angehängt werden können, ohne das Layout zu brechen. Das ist derselbe Trick, den sockaddr und die Win32-API seit Jahrzehnten nutzen. Enums sind auf jedem Compiler auf int festgelegt, soweit der C-Standard das erlaubt, denn ein Enum, dessen zugrunde liegender Typ zwischen Compilern wechselt, ist eine ABI-Zeitbombe. Nichts davon ist exotisch. Alles davon tut man nur, wenn man am ersten Tag entscheidet, dass das ABI ein Produktmerkmal ist und kein Zufall des aktuellen Quellcode-Layouts. Das ist die Lücke zwischen Spezifikation und Implementierung in Reinform: Das ABI ist die Spezifikation, alles andere ist verhandelbar.

  • Opake Handles für alles. Aufrufer sehen nie das Layout, also kann es sich frei ändern.
  • Enum-basierte Getter und Setter. Neue Einstellungen sind neue Konstanten, keine neuen Symbole, und alte Bibliotheken antworten mit GHOSTTY_UNSUPPORTED statt abzustürzen.
  • Selbstdimensionierende öffentliche Structs. Ein struct_size-Feld erlaubt späteres Anhängen von Feldern; reserviertes Padding schafft künftigen Platz.
  • Festgelegte Enum-Typen. Enums sind auf int fixiert, damit sich das ABI zwischen Compilern nicht verschiebt.
  • Versionierte Symbole auf ELF. Der dynamische Loader lehnt eine nicht passende Bibliothek namentlich ab, laut und beim Laden, nicht rätselhaft zur Laufzeit.

ABI-Stabilität in der CI erzwingen, nicht durch gute Absichten

Jedes Projekt behauptet Abwärtskompatibilität. Fast keines kann das an einem beliebigen Dienstag beweisen. Die CI von libghostty führt libabigail gegen eine eingecheckte Baseline unter Linux aus, prüft jede Änderung auf ABI-Drift und vergleicht Golden-Type-Manifeste auf macOS und WebAssembly. Exportierte Symbole auf ELF-Plattformen sind versioniert, sodass der Loader selbst zum Durchsetzungsmechanismus wird. Das Versprechen wird nicht durch Code-Reviews und Wachsamkeit gehalten, sondern durch Maschinen, die den Build fehlschlagen lassen, wenn ein Mensch einen Fehler macht.

Ein ABI ist kein Vertrag, den man einmal unterschreibt. Es ist ein Versprechen, das deine CI bei jedem einzelnen Commit halten muss.

Das ist der Baustein, den ich jedem Bibliotheksautor zuerst ans Herz legen würde, noch vor jedem API-Design. Automatisierte ABI-Prüfung ist günstig einzurichten, denn libabigails abidiff ist ein einziges Tool. Sie verwandelt ein unscharfes soziales Versprechen („wir versuchen, nichts kaputtzumachen“) in ein hartes, überprüfbares Artefakt („hier ist die Baseline; hier ist der Diff; diese Änderung ist kompatibel oder nicht“). Distributionen, die entscheiden, ob sie deine Bibliothek paketieren, und Firmen, die entscheiden, ob sie sie dynamisch einbinden, bewerten im Grunde genau dieses Artefakt. Dass die Maintainer von Neovim auf ein getaggtes Release gewartet haben, bevor sie mergten, ist keine Förmlichkeit. Distributionen brauchen eine versionierte, separat paketierbare Abhängigkeit mit einer Kompatibilitätsgeschichte, die sie verteidigen können.

Eine Wächterfigur misst eine Steinbrücke am Eingang und prüft sie, bevor sie den Durchgang erlaubt.
ABI-Stabilität als Kontrollpunkt erzwungen: Jede Änderung wird vor dem Übergang an der Baseline gemessen.

Paketierung und Lizenzierung: Die unscheinbare Arbeit, die Bibliotheken ausliefert

Frag einen Distributionsbetreuer, was die Chancen einer Bibliothek zunichtemacht, und er wird selten „der Code“ sagen. Es ist der Build, der --prefix oder DESTDIR ignoriert, die fehlende SONAME, die vendorten Abhängigkeiten mit unklaren Lizenzen, das Tarball, das offline nicht baut. Libghostty 1.0 behandelt all das als Release-Oberfläche: signierte Quell-Tarballs, ein begleitendes Abhängigkeits-Tarball im Cache-Layout von Zig für vollständig offline Builds, saubere SONAMEs, pkg-config-Dateien, CMake-Paketkonfigurationen und standardmäßig behaltene Debug-Infos, damit Distributionen sie strippen können. Es gibt eine PACKAGING-LIBGHOSTTY.md, die im Tarball ausgeliefert wird, geschrieben für den Paketierer und nicht für den Endnutzer.

Die Lizenzierung wurde genauso behandelt, und sie ist strategischer, als sie aussieht. Die Bibliothek steht unter MIT, braucht zur Laufzeit nichts außer libc (und lässt sich sogar freistehend ohne diese bauen) und bindet eine Handvoll freizügig lizenzierter Abhängigkeiten ein: simdutf und Google Highway für SIMD, eine kompakte Unicode-Tabelle, Wuffs für die Dekodierung von Kitty-Grafiken. Gebaut wird ohne libc++, sodass es keine Abhängigkeit von der C++-Standardbibliothek gibt. Kein Copyleft irgendwo im Baum. Jede Abhängigkeit steht in einem maschinenlesbaren Manifest mit Version, SPDX-Lizenz und Hash, gerade damit Distributionen die Metadaten gebündelter Bibliotheken ohne Archäologie ergänzen können. Es gibt sogar ein Build-Flag, um stattdessen das systemeigene simdutf oder Highway dynamisch zu linken.

Jede dieser Entscheidungen beseitigt einen konkreten Einwand, den ein bestimmter Torwächter erheben würde. Das ist in der Praxis, was „unternehmenstauglich“ wirklich bedeutet: nicht eine Verkaufsseite, sondern hundert kleine Reibungspunkte, die abgeschliffen wurden, bevor überhaupt jemand fragen musste. Es ist auch eine Erinnerung daran, warum großartige Software Zeit braucht. Keine dieser Arbeiten ist schwer, aber alle sind langsam.

Portabilität und Ressourcendisziplin als API-Versprechen

Die getestete Plattformmatrix umfasst Linux (glibc und musl), macOS, iOS, FreeBSD, Windows, Android und freistehendes WebAssembly. Dazu kommt eine zweite Stufe, die in der CI gebaut wird, aber noch keine Tests ausführt: Bare-Metal RISC-V und ARM Thumb, WASI, Windows ARM64, illumos und 32-Bit-x86. Jede Plattform bekommt die Artefakte, die ihr Ökosystem erwartet: dylibs mit @rpath und XCFrameworks für Apple, eine DLL mit PDB und Import-Bibliothek für Windows (MSVC-Linking in der CI verifiziert), einen Android-Build mit 16-KB-Seitengröße für Android 15+ und ein WASM-Modul unter einem Megabyte mit allen Features aktiviert. Halbieren lässt es sich, indem Subsysteme wie Suche, Auswahl und Kitty-Grafiken ausgeschlossen werden. Dabei wird jede Funktion weiterhin exportiert und liefert GHOSTTY_UNSUPPORTED zurück, damit der Code des Einbettenden nie geändert werden muss.

Doch die Portabilitätsgeschichte, zu der ich immer wieder zurückkomme, ist verhaltensbezogen. Die Bibliothek erzeugt keine Threads. Sie alloziert nur über einen Allocator, den du bereitstellst. Der Autor berichtet, 10.000 laufende Terminals betrieben zu haben, die jeweils eine echte Shell mit Ausgabe antreiben, auf einem Linux-Server mit 4 Kernen und 8 GB RAM. Er merkt an, der Engpass sei der Speicherhunger von bash gewesen, nicht die Bibliothek; er musste auf dash umstellen, um die Shells in den Arbeitsspeicher zu bekommen, während libghostty-vt unbeirrt weiterlief. „Wir erzeugen keine Threads“ und „Wir besitzen deinen Allocator nicht“ sind API-Versprechen, so real wie jede Funktionssignatur. Genau sie machen eine Bibliothek einbettbar in Kontexten wie Spiele-Engines, eingebetteten Geräten, Fuzzing-Harnesses oder fremden Event-Loops, in denen eine threadhungrige Abhängigkeit ein Ausschlusskriterium wäre.

Was libghostty über Library-first-Architektur lehrt

Der naheliegende Vergleich ist libvte, die GTK-gebundene Emulationsbibliothek unter GNOME Terminal, dem XFCE-Terminal und einem halben Dutzend anderer. libvte hat das Modell vor Jahren bewiesen, ein gemeinsamer Kern mit vielen schlanken Wrappern, aber seine GTK-Kopplung hat seine Welt auf Linux-Desktops mit einem bestimmten Toolkit eingegrenzt. Libghostty setzt darauf, dass dasselbe Modell, von jedem UI-Toolkit entkoppelt und zu einem stabilen C-ABI gehärtet, viel weiter reicht: in IDEs in Java, Editoren in C, TUIs in Go, Browser über WASM und kommerzielle Produkte, die niemals eine GTK-Abhängigkeit ausliefern könnten. Erste Belege sagen, die Wette ist richtig. Mehr Leute nutzen bereits ein libghostty-basiertes Terminal als Ghostty selbst, und das um ein Vielfaches.

Die tiefere Lehre betrifft die Reihenfolge. Library-first-Architektur bedeutet nicht, eine Bibliothek zu schreiben, bevor es einen Anwendungsfall gibt, denn so entstehen wunderschöne Abstraktionen, die niemand braucht. Ghostty ging den umgekehrten Weg: Es baute eine echte Anwendung, ließ die Domänengrenzen unter Produktionsdruck entstehen und härtete dann die Naht, die es die ganze Zeit ohnehin gepflegt hatte. Die C-API kam spät, und genau deshalb kam sie sauber. Wenn du an einer Anwendung mit einem wirklich schwierigen, wiederverwendbaren Kern sitzt, etwa einem Parser, einem Emulator, einer Layout-Engine oder einem Protokoll-Stack, ist das Playbook hier sichtbar: Halte die Grenze von Anfang an ehrlich, stelle sie über den schmalstmöglichen Vertrag bereit, setze das ABI unter CI-Überwachung und erledige die Paketierungsarbeit mit vollem Einsatz. Die Effekte im Ökosystem verstärken sich von dort aus. Jeder Bug, den ein Einbettender meldet, macht das Terminal jedes anderen Konsumenten besser, und jedes neue Protokoll landet überall gleichzeitig, statt sich über ein Dutzend private Forks zu zersplittern.

Hashimoto behauptet, man könne heute ein Terminal in etwa 1.500 Zeilen C bauen, das nahezu alles übertrifft, was vor einem Jahr existierte. Das ist genau die Art Satz, die ich normalerweise unter Begeisterung des Maintainers abheften würde. Nur dass hunderte verfolgte Projekte und die gesamte JetBrains-IDE-Flotte nahelegen, dass die Behauptung der Realität standhält. Die Ära, in der jede Anwendung ihren eigenen Terminal-Emulator von Hand baut, könnte endlich zu Ende gehen, und sie endet so, wie diese Dinge meist enden: nicht mit einer besseren Anwendung, sondern mit einer besseren Bibliothek.