frogmouth

Frogmouth is a terminal-based Markdown viewer and browser built with Textual. It opens both local .md files and remote URLs, providing a browser-like experience within the terminal. The application includes navigation features such as a back/forward stack, browsing history, bookmarks, and a table of contents for document navigation.

The tool supports both keyboard and mouse navigation, with tab-based control switching between interface elements. A notable feature is the gh command integration, which allows users to load README files directly from GitHub repositories using syntax like frogmouth gh textualize/textual. This same functionality works within the application's address bar.

Frogmouth runs on Linux, macOS, and Windows, requiring Python 3.8 or above. It's designed for developers, technical writers, and anyone who needs to view Markdown documentation efficiently without leaving the terminal environment.

Installation

# via pipx
pipx install frogmouth

# via pip
pip install frogmouth

# via Homebrew
brew tap textualize/homebrew && brew install frogmouth