攔截源頭

• 發現管道：GitHub 專案 Textualize/frogmouth
• 攔截原因：我平常要看 README.md 或專案文件，尤其是目前使用 AI Agent，例如 Claude Code，這時候還要切出去執行檔案很麻煩。看到 Frogmouth 可以像瀏覽器一樣在 terminal 裡看 Markdown，馬上覺得值得一試。

技術初探

• 官方定義：Frogmouth 是一個基於 Textual 打造的 Markdown 瀏覽器，可以在終端機裡瀏覽本地或遠端的 .md 文件 。

• 核心賣點：

  • 支援本地與遠端檔案（包含 GitHub repo 的 README）
  • 具備「瀏覽器式操作」：返回、前進、書籤、目錄
  • 支援鍵盤與滑鼠操作
  • 介面清晰，和原始 Markdown 純文字相比好讀太多

• 適用場景：

  • 快速瀏覽 README / 文件，不想開 GUI
  • 在 SSH 遠端環境看文件
  • Terminal-first 的開發者

實戰使用

快速安裝

# pipx（官方推薦）
pipx install frogmouth

# pip
pip install frogmouth

# Homebrew
brew tap textualize/homebrew
brew install frogmouth

Hello World

# 打開本地文件
frogmouth README.md

# 直接打開 GitHub repo 的 README
frogmouth gh textualize/textual

實際應用

在專案根目錄直接：

frogmouth README.md

看 GitHub 上的專案 README：

frogmouth gh plutov/oq

不用開網頁，直接在 CLI 讀 repo 文件。

記憶碼摘要

技術：Frogmouth
分類：CLI 工具 / Markdown Viewer
難度：⭐☆☆☆☆（1-5顆星）
實用度：⭐⭐⭐⭐☆（1-5顆星）
一句話：讓你在 terminal 裡優雅瀏覽 Markdown，就像文件的瀏覽器
關鍵指令：frogmouth gh owner/repo
適用情境：Terminal-first 開發、SSH 環境、快速查看 README

結語

試用 Frogmouth 之後，我發現 Markdown 文件不一定非得靠瀏覽器或 VSCode 來看。在 terminal 就能有「渲染過的閱讀體驗」，這對我來說減少了很多 context switching。

目前在使用 AI-Driven Development 的開發方式（AI-Driven Development - 個人開發者的敏捷實踐），很常會需要配合 Claude Code 來進行開發，這時候用這個工具查看文件，包含 PRD, User Story（這些都會產出 md 檔案），真的十分方便～