glowed - Trình duyệt/trình biên tập Markdown trong terminal cho Ghostty

glowed là một công cụ TUI để tìm kiếm, xem trước và chỉnh sửa tài liệu Markdown trong dự án ngay trong terminal Ghostty.

Cá nhân tôi đã tạo nó vì cần một quy trình để nhanh chóng duyệt các tệp .md trong hệ thống quản lý tri thức ngay trong terminal, rồi chuyển phần cần thiết sang LLM CLI. Đặc biệt, từ nhu cầu chỉ mở terminal và muốn duyệt, đọc tài liệu thật nhanh, tôi đã dành khoảng hai ngày để vibe coding và làm ra nó.

Có thể cài đặt bằng Homebrew tap.

brew install khw1031/tap/glowed  

Ví dụ sử dụng như sau.

 cd my-project  
 glowed  
  
 # hoặc mở trực tiếp một tệp cụ thể  
 glowed ./docs/note.md  

Các tính năng hiện được hỗ trợ như sau.

• quét các tệp .md dưới project root
• tìm kiếm theo tên tệp, frontmatter, tag: / tags:
• xem trước Markdown dựa trên Glamour
• chế độ chỉnh sửa Markdown thô
• backup + atomic write khi lưu
• undo/redo
• selection dựa trên mouse click/wheel/drag
• trong source selection mode, sao chép Markdown gốc kèm path metadata
• footer action bar
• keymap có thể cấu hình
• external LLM CLI session launcher
  • có thể cấu hình CLI chạy được trong PATH như claude, codex, aider, hoặc wrapper script tự tạo

Về phía LLM, glowed không trực tiếp xử lý API key hay OAuth, mà mở CLI mà người dùng đã đăng nhập sẵn trong một Ghostty split/session mới.

Các giới hạn hiện tại cũng khá rõ ràng. (Nó được vibe coding cho mục đích dùng cá nhân và phù hợp với môi trường cá nhân...)

• được làm dựa trên macOS + Ghostty
• chưa được kiểm thử đầy đủ trên iTerm2, Terminal.app, WezTerm, Kitty, tmux, SSH, Linux terminal, v.v.
• mouse tracking, drag selection, cursor/key sequence, và việc chạy Ghostty split có thể bị ảnh hưởng nhiều bởi môi trường
• trên màn hình preview, phần rendered text được chọn chưa được ánh xạ ngược chính xác sang line/column của Markdown gốc. Để sao chép Markdown gốc, cần dùng edit mode hoặc source selection mode.
• đây vẫn là MVP giai đoạn đầu, nên với tài liệu quan trọng, khuyến nghị dùng cùng version control như git

Quá trình phát triển cũng đã được ghi trong README. Bản triển khai hiện tại được tạo bằng Codex GPT-5.5, pi agent coding harness, và local TODO.md planning file.

Dự án này cũng đang thử nghiệm một cách quản lý mã nguồn mở mới phù hợp với thời đại AI.

Thay vì gom mọi cải tiến về upstream PR như trước đây, trước mắt tôi khuyến nghị người dùng tự do sửa đổi theo workflow của mình và phát hành qua Homebrew tap riêng.

Ví dụ, ngay cả khi cùng tên formula là glowed, chỉ cần namespace của Homebrew tap khác nhau thì vẫn có thể phát hành riêng.

  brew install khw1031/tap/glowed  
  brew install someone/tap/glowed  

Tức là người dùng có thể tạo phiên bản riêng như someone/tap/glowed để tự do sử dụng và phát hành. Nếu cần, có thể giữ nguyên tên binary là glowed, hoặc đổi thành glowed-someone để nhiều phiên bản cùng tồn tại.

Nếu bạn công khai phiên bản đã chỉnh sửa, sẽ rất tốt nếu thông báo qua Distribution registration trong GitHub issue. Đây không phải yêu cầu phê duyệt, mà để chia sẻ hiện đang có những phiên bản nào. Nếu đã chỉnh sửa bằng AI agent hoặc coding harness, cũng khuyến nghị ghi kèm agent/model/method đã dùng. Tôi sẽ xem qua, và những ý tưởng hoặc thay đổi mà tôi thấy cần thiết có thể sẽ được phản ánh trực tiếp vào kho lưu trữ này. Vì vậy, các bản phân phối lại cần dùng LICENSE cho phép sử dụng tự do.

---

P.S.

Nói thêm, hiện tại tôi đang tìm kiếm cơ hội mới. Tôi đã làm việc với vai trò FE developer, và rất quan tâm tới AI Transformation tận dụng agent cũng như việc cải thiện workflow cho cả phát triển và phi phát triển. Tôi cũng có kinh nghiệm xây dựng workflow dựa trên agent trong nội bộ công ty để nâng cao hiệu quả công việc. Nếu có cơ hội phù hợp, hãy thoải mái liên hệ qua hồ sơ GitHub :)