Show GN: glowed — Ghostty용 터미널 Markdown 브라우저/에디터 완벽 가이드

glowed — Ghostty 터미널용 Markdown 브라우저/에디터

Show GN: glowed — Ghostty용 터미널 Markdown 브라우저/에디터 완벽 가이드

Ghostty 터미널 환경에서 프로젝트 문서를 빠르고 직관적으로 관리할 수 있는 새로운 도구가 등장했다. glowed는 Markdown 문서를 검색, 미리보기, 편집할 수 있는 TUI 기반 브라우저/에디터로, 개발자 워크플로우에 최적화된 다양한 기능을 제공한다. 특히 LLM CLI와긴밀결합한 것이 특징이다.

glowed란 무엇인가

glowed는 Ghostty 터미널에서 동작하는 TUI 도구로, 프로젝트 루트 디렉터리 안의 Markdown 파일을 스캔하고 실시간으로 검색·미리보기·편집할 수 있다. 현재 필자가 가장 주목하는점시 다음과 같다.

핵심 가치:

• 터미널만 열어놓고 문서를 빠르게 탐색하고, 필요한 부분은 바로 LLM CLI로 넘기는 흐름

• 바이브 코딩으로 단 이틀 만에 만들어진 만큼 개발자 친화적인 설계

• 외부 LLM CLI를 통합하여 선택한 내용을 기반으로 AI와 대화 가능

주요 기능 정리

Markdown 파일 스캔 및 검색

프로젝트 root에서 glowed를 실행하면 하위 디렉터리의 모든 .md 파일을 자동으로 스캔한다. 파일명뿐 아니라 frontmatter와 tag 기반으로도 검색할 수 있어, 수백 개의 문서가 있는 대규모 프로젝트에서도 원하는 파일을 즉시 찾을 수 있다.

# 프로젝트에서 glowed 실행cd my-projectglowed# 특정 파일 바로 열기glowed ./docs/note.md

Glamour 기반 Markdown 미리보기

Glamour 라이브러리를 사용하여 깔끔한 Markdown 미리보기 화면을 제공한다. 렌더링된 텍스트를 터미널 내에서 바로 확인할 수 있어, 별도의 GUI 도구 없이도 문서 품질을 검증할 수 있다.

편집 및 안전장치

편집 모드에서는 원본 Markdown을 직접 수정할 수 있다. 특히 저장 시 backup 생성 + atomic write를 지원하므로, 편집 중 실수가 발생해도 안전하게 복원할 수 있다. Undo/Redo 기능도 지원하여 장시간 편집 작업도 부담 없이 진행할 수 있다.

마우스 기반 선택 기능

마우스 클릭, 휠, 드래그를 활용한 직관적인 텍스트 선택이 가능하다. 선택한 텍스트를 source selection mode에서 원본 Markdown의 경로 메타데이터와 함께 복사할 수 있어, 코드 리뷰나 문서 참조 시 매우 편리하다.

외부 LLM CLI 통합

glowed의 가장 독특한 기능 중 하나는 외부 LLM CLI 세션 런처다. Footer 액션 바에서 바로 Claude, Codex, Aider 등 PATH에서 실행 가능한 CLI를 호출할 수 있다. 이 방식은 API Key나 OAuth를 직접 다루지 않고, 사용자가 이미 로그인해 둔 CLI를 새 Ghostty split이나 session에서 여는 것이 특징이다.

# glowed 설정 예시 (LLM CLI 연동)# ~/.glowed/config 또는 프로젝트 내 설정 파일에서llm_cli: claude      # 또는 codex, aider,자정의 wrapper script

설치 방법

Homebrew tap으로 간편하게 설치할 수 있다.

brew install khw1031/tap/glowed

현재 제한사항

아직 초기 MVP 단계인 만큼 일부 제약이 존재한다.

제한사항	설명
macOS + Ghostty 전용	iTerm2, Terminal.app, WezTerm, Kitty, tmux, SSH, Linux 터미널 등에서는 충분히 테스트되지 않음
Mouse tracking	환경에 따라 동작이 달라질 수 있음
Ghostty split 실행	호환성 문제가 발생할 수 있음
렌더링 → 원본 역매핑	미리보기 화면에서 선택한 렌더링 텍스트를 원본 Markdown의 정확한 줄/열로 역매핑하지는 않음
원본 Markdown 복사	미리보기 대신 Edit mode나 Source selection mode를 사용해야 함

> ⚠️ 아직 초기 단계이므로, 중요한 문서는 항상 git 등 버전 관리 시스템과 함께 사용할 것을 권장한다.

AI 시대의 새로운 오픈소스 배포 방식

glowed 개발자는 이 프로젝트에서 독특한 오픈소스 배포 방식도 실험하고 있다. 기존처럼 모든 개선을 upstream PR로 모으는 방식이 아니라, 사용자가 자신의 workflow에 맞게 자유롭게 수정하고 각자의 Homebrew tap으로 배포하는 방식을 권장한다.

# 원본 버전brew install khw1031/tap/glowed# 다른 개발자의 커스텀 버전brew install someone/tap/glowed

같은 formula 이름이라도 Homebrew tap namespace가 다르면 각각 배포할 수 있다. Binary 이름도 glowed로 유지하거나 glowed-someone처럼 여러 버전과 공존하도록 바꿀 수 있다. 수정한 버전을 공개한다면 GitHub Issue의 Distribution registration에 알려주면 다른 버전 목록을 공유할 수 있다.

개발 과정에서 주목할 점

개발자는 이 프로젝트를 만드는 데 Codex GPT-5.5, pi agent coding harness, local TODO.md planning file을 사용했다고 밝히고 있다. AI Agent나 Coding harness로 수정했다면 어떤 Agent/Model/Method를 썼는지도 함께 적기를 권장한다.

이는 곧 AI 시대에 맞는 새로운 오픈소스 기여 문화의 시작을 의미한다. 모든 수정이상유 PR로 통합되지 않더라도, 각자의 workflow에 맞춰 도구를개혁발전하고 커뮤니티와 공유하는 방식이다.

함께 보면 좋은 관련 도구

도구	설명
mdvi	CLI 기반 Markdown 뷰어
cmux	AI 코딩 에이전트를 위한 Ghostty 기반 macOS용 터미널
OpenClaw	모든 OS와 플랫폼에서 작동하는 개인용 AI 비서
Spegel	LLM을 활용해 웹페이지를 재구성하는 터미널 브라우저

결론

glowed는 Ghostty 환경에서 Markdown 문서를 효율적으로 관리하고, LLM CLI와 seamless하게 통합하는 도구다. 특히 개발 과정에서 빠르게 문서를 탐색하고 AI 도구를 활용하려는 분이라면일시할 가치가 있다. 다만 현재는 macOS + Ghostty 환경에 최적화되어 있으므로, 다른 터미널 환경을 사용하는 분들은 호환성을 확인한 후 설치하길 권장한다.

---

📚 출처

• glowed - GitHub

• GeekNews - glowed 소개

---

📚 출처

• https://news.hada.io/topic?id=29592