← 목록으로
지난 소식
libghostty 1.0 공개 - Ghostty의 터미널 엔진을 안정적인 C 라이브러리로
요약
- Ghostty의 터미널 엔진을 분리한 libghostty 1.0이 공개되어 안정적인 C 라이브러리 형태의 C ABI를 제공한다.
- JetBrains IDE, Neovim, Turborepo 등 다양한 개발 도구와 상용 제품에서 이를 도입하거나 연동하고 있다.
- MIT 라이선스를 채택하고 시맨틱 버저닝과 엄격한 ABI 호환성 정책을 적용해 배포판 패키징과 오프라인 빌드를 지원한다.
- Ghostty의 터미널 엔진을 분리한 libghostty-vt가 1.0에 도달함. 다른 앱도 이 라이브러리를 연결해 자체 터미널을 구현할 수 있음
- C ABI가 안정화돼 배포판이 라이브러리를 별도 패키지로 제공하고, 앱은 이를 동적으로 연결할 수 있음. Ghostty 앱과 별도로 릴리스하며, 오프라인 빌드에 필요한 소스와 의존성도 제공함
- JetBrains IDE의 내장 터미널에 이미 적용됐으며, Turborepo의 작업 출력 렌더링과 TUI 프로그램 테스트에도 쓰임
- Neovim도 libvterm을 교체하는 PR을 승인함. 병합 대기 중인 이 변경에는 창 크기를 바꿀 때 이전 터미널 출력도 새 너비에 맞춰 줄을 다시 배치하는 수정이 포함됨
- MIT 라이선스이며 기본 런타임 의존성은 libc뿐임. Linux, macOS, Windows, iOS, Android, FreeBSD와 WebAssembly에서 빌드와 테스트를 수행함
1.0의 범위와 도입 현황
- libghostty는 Ghostty 코어에서 직접 추출한 이식 가능한 고성능 C 터미널 에뮬레이션 라이브러리임
- 1년여 전 초기 소개 당시에는 Zig 모듈만 병합됐고 C API가 없었으며, Ghostty만 사용하고 있었음
- 현재 C API는 완전한 터미널 에뮬레이터를 제공하며, 무료 및 상용 제품 수백 개의 프로덕션 환경에서 사용됨
- JetBrains IDE의 터미널은 libghostty 기반으로 전환됨
- IntelliJ, PyCharm, GoLand 등의 사용자가 대상이며, JetBrains의 연례 보고서 기준 활성 사용자는 1,250만 명 이상임
- 1년 전에는 기존 에뮬레이터인 JediTerm의 버그가 터미널 구현의 어려움을 보여주는 사례였음
- 대부분의 도입 제품이 사용량을 공개하지 않아 전체 사용자 규모는 대략적인 수치임
- Neovim은 libvterm을 libghostty-vt로 대체하는 PR을 승인했으나 아직 병합하지 않았음
- 창 크기 변경 시 스크롤백을 재배치하는 10년 된 이슈도 해결함
- 배포판이 의존성을 별도 패키징할 수 있도록 태그된 릴리스를 기다리고 있었으며, 이번 릴리스로 그 조건을 충족할 수 있게 됨
터미널 밖으로 확장된 생태계
- 터미널과 개발 도구가 자체 에뮬레이터를 새로 만드는 대신 libghostty를 활용하고 있음
- KDE 개발자들은 Konsole 대체 프로그램을 실험 중임
- Vercel의 Turborepo는 TUI에서 작업 출력을 렌더링하고, devenv는 셸 구동에 사용함
- Ghostel은 Emacs에 통합하고, ghostty-web은 Xterm.js 호환 API를 갖춘 WASM 빌드를 제공함
- 상용 제품 OrbStack과 새로운 터미널 및 에이전트 코딩 도구인 herdr, cmux도 활용함
- Antithesis는 TUI 프로그램 퍼징 에 사용해 btop 등에서 실제 버그를 발견함
- 커뮤니티 언어 바인딩은 Rust, Go, JavaScript, Swift, Python, .NET, Elixir, Dart, Java 등을 지원함
- awesome-libghostty는 100개를 훨씬 넘는 프로젝트를 추적함
- libghostty 기반 터미널 사용자는 Ghostty 앱 사용자보다 훨씬 많음
ABI 안정성 설계와 검증
- 1.0부터 시맨틱 버저닝과 엄격한 ABI 호환성 정책을 적용해 운영체제와 배포판의 패키징, 프로그램의 동적 링크를 뒷받침함
- 모든 객체는 불투명 핸들이며, 수백 개의 읽기/쓰기 값은 열거형 키를 받는 소수의 getter/setter로 접근함
- 새 심볼 없이 값을 추가할 수 있음
- 새 헤더로 작성한 프로그램이 이전 라이브러리에 링크되면, 지원하지 않는 기능은 충돌이나 미정의 동작 대신 GHOSTTY_UNSUPPORTED를 반환함
- 소수의 비불투명 구조체에는 크기 정보 또는 예약 패딩을 넣어 향후 필드 추가에 대비함
- C 표준이 허용하는 범위에서 모든 컴파일러의 열거형을 int로 고정함
- CI가 ABI 정책을 강제함
- Linux에서는 모든 변경을 libabigail로 저장된 기준과 비교함
- macOS와 WebAssembly에서는 기준 타입 명세와 비교함
- ELF 플랫폼은 모든 공개 심볼에 버전을 붙여, 불일치하는 라이브러리를 동적 로더가 로드 단계에서 거부하도록 함
배포판 패키징과 독립 릴리스
- libghostty는 Ghostty 앱과 별도의 릴리스 주기를 가짐
- 필요한 파일과 의존성만 담은 전용 tarball로 크기를 줄이고 라이선스 검증과 호환성 확인을 단순화함
- 1.0에는 주요 운영체제와 배포판의 표준 도구로 패키징할 수 있도록 빌드 도구, 의존성 라이선스 명세, 문서를 갖춤
- 각 릴리스는 서명된 소스 tarball과 Zig 캐시 구조로 모든 Zig 패키지를 담은 의존성 tarball을 제공해 완전한 오프라인 빌드를 지원함
- 빌드는 적절한 SONAME을 갖춘 공유/정적 라이브러리, 헤더, pkg-config 파일, CMake 패키지 설정을 설치함
- --prefix, DESTDIR, lib64를 지원하며, 배포판이 별도로 분리할 수 있도록 디버그 정보를 기본 유지함
- 자세한 절차는 tarball에도 포함된 PACKAGING-LIBGHOSTTY.md에 정리돼 있음
의존성과 라이선스
- libghostty-vt는 MIT 라이선스이며, 기본 빌드의 런타임 의존성은 libc뿐임
- SIMD 경로와 기본 malloc 할당자 때문에 기본 빌드는 libc에 링크됨
- SIMD를 끄면 libc 없이 독립 실행형으로 빌드할 수 있으며, 베어메탈 RISC-V와 ARM에서도 이 방식으로 실행함
- 소수의 허용적 라이선스 의존성을 라이브러리에 컴파일해 포함함
- SIMD에는 simdutf와 Google Highway를 사용함
- 문자소 데이터에는 작은 Unicode 테이블을, Kitty 그래픽 프로토콜의 이미지 디코딩에는 Wuffs를 사용함
- simdutf와 Highway는 libc++ 없이 빌드하므로 C++ 표준 라이브러리에 의존하지 않음
- 의존성 트리에는 카피레프트 코드가 없음
- 각 의존성의 버전, SPDX 라이선스, 해시를 기계 판독 가능한 명세에 기록해 배포판의 번들 라이브러리 메타데이터 작성을 돕음
- 시스템 simdutf나 Highway에 동적으로 링크하는 빌드 옵션도 제공함
플랫폼 지원과 자원 사용
- 다음 플랫폼에서는 CI 빌드와 전체 단위 테스트 및 예제 실행을 수행함
- Linux glibc/musl: x86_64, aarch64
- macOS 13 이상: x86_64, aarch64
- iOS 13 이상: aarch64
- FreeBSD: x86_64, aarch64
- Windows: x86_64
- Android: aarch64, x86_64, arm
- 독립 실행형 WebAssembly: wasm32
- 빌드만 검증하고 자동 실행 테스트는 하지 않는 대상도 있음
- 베어메탈 riscv32/thumb, WebAssembly WASI wasm32, Windows arm64, illumos x86_64, 32비트 x86임
- 실제 사용자는 있지만 자동 테스트 환경은 아직 구축하지 않았음
- 플랫폼별 패키지는 각 생태계의 링크 및 배포 방식을 지원함
- Linux/FreeBSD에는 SONAME과 버전 심볼을 갖춘 공유 라이브러리 등을 제공함
- macOS/iOS에는 @rpath 설치 이름과 호환성 버전을 갖춘 dylib, macOS/iOS/시뮬레이터용 XCFramework를 제공해 Xcode와 Swift Package Manager에서 사용할 수 있음
- Windows에는 DLL, .pdb, 임포트 라이브러리, 정적 라이브러리를 제공함. GNU ABI로 빌드하지만 MSVC 프로그램의 임포트 라이브러리 링크도 CI에서 검증함
- Android는 NDK 기반 공유 라이브러리와 Android 15 이상에서 요구하는 16KB 페이지 크기를 지원함
- WebAssembly는 속도 최적화판과 크기 최적화판을 제공하며, 크기 최적화판은 모든 기능을 켜도 1MB 미만임
- 읽기 전용 뷰어라면 입력 인코딩, 검색, 선택, Kitty 그래픽 등을 빌드에서 제외해 모듈 크기를 대략 절반으로 줄일 수 있음
- 함수를 제거하지 않고 GHOSTTY_UNSUPPORTED를 반환하므로 호출 코드를 바꿀 필요가 없음
- 기능 선택 옵션은 WASM뿐 아니라 모든 타깃에서 사용할 수 있음
- 라이브러리는 스레드를 만들지 않으며, 모든 메모리 할당에 사용자 지정 가능한 할당자를 사용함
- 개발자의 실험에서는 4코어, RAM 8GB Linux 서버에서 실제 셸이 출력을 생성하는 활성 터미널 1만 개를 실행함
- 이 실험은 dash를 사용했으며, bash는 libghostty-vt보다 RAM을 훨씬 많이 사용해 8GB 안에 들어가지 않았음
이후 개발 방향
- 약 1,500줄의 C 코드로 만든 터미널은 간결한 구현 사례임
- 기능과 성능 비교 범위는 터미널 프로토콜/시퀀스 지원, 파싱 처리량, 메모리 사용량으로 한정됨
- 개발자의 비교에 따르면, 이 범위에서 2025년에 존재한 거의 모든 터미널과 2026년 현재 대부분의 터미널보다 더 많은 기능과 나은 성능을 제공함
- 다양한 언어 바인딩으로 주요 프로그래밍 언어에서도 활용할 수 있음
- 앞으로 안정성을 유지하면서 가능한 많은 터미널 프로토콜을 구현하고, 도입 제품이 선택할 수 있도록 활성화/비활성화 옵션을 제공할 계획임
- 어느 도입 제품에서 발견한 버그든 수정 효과를 공유하고, 새 기능을 생태계 전체에 빠르고 안전하게 전달해 개발 속도 향상과 파편화 감소를 추구함
- 문서, 예제, 다운로드는 lib.ghostty.org에서 제공함
키워드
libghosttyGhostty터미널 엔진