h.n.r

A terminal UI for Hacker News

Browse stories, read threaded comments, search, vote, reply, and bookmark — all without leaving the terminal. Built with Rust and ratatui. Mostly vibe coded with Claude Code over a weekend.

Features

• Six feeds — Top, New, Best, Ask HN, Show HN, Jobs
• Threaded comments — recursive tree with inline expand/collapse per comment
• Comment prefetch — comments are fetched automatically after a short dwell on any story and the pane switches without pressing Enter; works for Algolia search results too
• Reader mode — press r to fetch and render any article as structured text with headings, code blocks, quotes and lists (powered by Mozilla Readability); loads in the background with a progress indicator
• Shimmer progress — all async operations (feed refresh, article fetch, comment prefetch, search) show an animated shimmer indicator in the status bar
• Search — Algolia-powered full-text search; press ? to open, results drop into the story list
• Seen tracking — stories dim automatically when you open their comments; press u to mark unread (persisted to ~/.hnr/seen.json)
• Bookmarks — save stories with b, browse them on feed 7, persisted to ~/.hnr/bookmarks.json
• Voting & replies — upvote or reply to any story or comment when logged in
• User profiles — view karma, bio, and submission count for any author
• Open in browser — jump to the story URL or HN discussion page with o / O
• Clipboard — copy the story URL with y
• Session — login cookie saved to ~/.hnr/session and restored on next launch

Demo

Install

# Homebrew
brew tap prasanthj/hnr
brew install hnr

# Cargo
cargo install hnr

Usage

hnr

Keybindings

Key	Action
1 – 7	Switch feed: Top / New / Best / Ask / Show / Jobs / Bookmarks
j / k / ↑ / ↓	Navigate up / down
Enter	Fetch comments (story pane) · Expand / collapse comment inline
Tab	Switch between story list and comments pane
Esc	Back to story pane · Close modal
Space	Collapse / expand comment thread
r	Reader mode — fetch and render article as structured text
R	Refresh current feed
b	Bookmark / unbookmark selected story
u	Mark selected story as unread
?	Search stories via Algolia
v	Vote on selected story or comment
c	Reply to selected story or comment
p	View author profile
o	Open story URL in browser
O	Open HN discussion page in browser
y	Copy story URL to clipboard
l	Login / logout
h	Show help
/	Command mode
q	Quit

Reader mode keys

Key	Action
j / k	Scroll line by line
d / u	Half-page down / up
n / N	Jump to next / previous section
g / G	Jump to top / bottom
o	Open article in browser
Esc / q / r	Close reader

Slash Commands

/login      /logout     /top        /new        /best
/ask        /show       /jobs       /bookmarks  /search
/refresh    /user <n>   /bookmark   /open       /hn
/vote       /help       /quit

License

MIT