Repolode
coder

coder/ghostty-web

Ghostty의 WASM 컴파일 VT 파서를 기반으로 하며 xterm.js 호환 API를 제공하는 브라우저 터미널 에뮬레이터입니다.

스타
2,980
포크
186
열린 이슈
69
마지막 커밋
4일 전

어떤 프로젝트인가요?

ghostty-web은 Ghostty의 터미널 에뮬레이터를 npm 패키지로 브라우저에 제공합니다. 파서는 Ghostty 자체 소스 코드에서 WebAssembly로 컴파일되므로, JavaScript로 다시 구현한 것이 아니라 기본 Ghostty 앱에서 사용하는 것과 동일한 VT100 구현입니다.

이 라이브러리는 xterm.js와 API 호환성을 목표로 하므로, 기존 프로젝트는 `@xterm/xterm`을 `ghostty-web`으로 바꾸기만 하면 전환할 수 있습니다. 런타임 의존성이 없으며 약 400KB 크기의 WASM 번들을 제공합니다. README에 따르면 데바나가리 문자와 아랍어 같은 복잡한 문자 체계를 더 잘 처리하고, xterm.js가 구현하지 않은 XTPUSHSGR/XTPOPSGR도 지원합니다.

이 프로젝트는 병렬 에이전트 개발을 위한 데스크톱 앱인 Mux를 위해 만들어졌으며, 범용으로 사용할 수 있도록 설계되었습니다. npx 데모를 실행하면 루프백 주소에서 로컬 셸이 제공되며, 실행마다 발급되는 토큰으로 보호됩니다.

핵심 기능

  • 01Ghostty 소스 코드에서 WebAssembly로 컴파일한 파서
  • 02간편한 마이그레이션을 위한 xterm.js 호환 API
  • 03런타임 의존성 없이 약 400KB 크기의 WASM 번들 제공
  • 04복잡한 문자 체계의 그래핌을 올바르게 처리
  • 05XTPUSHSGR/XTPOPSGR 이스케이프 시퀀스 지원

활용 사례

  • 웹 기반 터미널이나 IDE 패널에서 xterm.js 대체
  • WebSocket으로 서버에 연결하는 브라우저 기반 셸 구축
  • 웹 기술로 만든 데스크톱 앱에 터미널 임베드
  • 라틴 문자 이외의 복잡한 문자 체계로 된 터미널 출력 렌더링

빠른 시작

  1. 1

    패키지를 설치하세요

    npm install ghostty-web
  2. 2

    가져와서 초기화한 다음 페이지 요소에서 터미널을 여세요(Usage 참고)

  3. 3

    또는 데모를 로컬에서 실행해 보세요

    npx @ghostty-web/demo@next

사용 전 알아둘 점

  • 소스에서 빌드하려면 Zig와 Bun이 필요합니다.
  • 데모는 실제 로컬 셸을 실행하므로 원격으로 노출하지 마세요.

토픽

자주 묻는 질문

ghostty-web은(는) 무엇인가요?
Ghostty의 WASM 컴파일 VT 파서를 기반으로 하며 xterm.js 호환 API를 제공하는 브라우저 터미널 에뮬레이터입니다. ghostty-web은 Ghostty의 터미널 에뮬레이터를 npm 패키지로 브라우저에 제공합니다. 파서는 Ghostty 자체 소스 코드에서 WebAssembly로 컴파일되므로, JavaScript로 다시 구현한 것이 아니라 기본 Ghostty 앱에서 사용하는 것과 동일한 VT100 구현입니다.
ghostty-web은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
ghostty-web은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
ghostty-web은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. ghostty-web의 마지막 커밋은 2026년 10월 15일입니다.
ghostty-web은(는) 어디에 사용할 수 있나요?
웹 기반 터미널이나 IDE 패널에서 xterm.js 대체 WebSocket으로 서버에 연결하는 브라우저 기반 셸 구축 웹 기술로 만든 데스크톱 앱에 터미널 임베드 라틴 문자 이외의 복잡한 문자 체계로 된 터미널 출력 렌더링
ghostty-web는 어떻게 설치하나요?
패키지를 설치하세요: npm install ghostty-web 가져와서 초기화한 다음 페이지 요소에서 터미널을 여세요(Usage 참고) 또는 데모를 로컬에서 실행해 보세요: npx @ghostty-web/demo@next
ghostty-web은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/coder/ghostty-web

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트