Chris Davies 8f9c66ba46 Initial commit: terminal file browser & markdown viewer
A beautiful TUI for browsing files and reading markdown/code:
- Two-pane layout with file tree and content viewer
- Markdown rendering via Glamour
- Syntax highlighting via Chroma
- Auto-detects light/dark terminal theme
- Arrow key navigation, Esc to go back
- Page Up/Down, Home/End for scrolling

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-28 20:13:09 -05:00

Reader

A beautiful terminal file browser and markdown viewer built with Go and the Charm ecosystem.

Features

  • File Tree Navigation: Browse directories with expand/collapse functionality
  • Markdown Rendering: Beautiful markdown display using Glamour
  • Syntax Highlighting: Code files rendered with Chroma
  • Vim-like Keybindings: Navigate efficiently with familiar keys
  • Responsive Layout: Adapts to terminal size

Installation

go build -o reader

Usage

# Open current directory
./reader

# Open a specific directory
./reader ~/Documents

# Show help
./reader --help

Keyboard Shortcuts

File Browser

Key Action
/ Move up/down
Enter Open file or folder
Collapse folder / go to parent
Expand folder / open file

Reading a File

Key Action
/ Scroll up/down
PgUp / PgDn Page up/down
Home / End Jump to top/bottom
Esc Back to file browser

General

Key Action
? Show help
q Quit

Built With

License

MIT

Description
A beautiful terminal file browser & markdown viewer
Readme 40 KiB
Languages
Go 100%