grokfeed 0.3.0

Hacker News + Reddit + lobste.rs terminal feed viewer

Terminal feed reader for Hacker News, Reddit, and lobste.rs.

Features

• Unified scrollable feed from HN, Reddit subreddits, and lobste.rs
• Color-coded by source: HN orange, lobste.rs red, subreddits in a cycling palette
• Read text posts and Ask HN inline — no browser needed
• Split view with post body and threaded comments side by side
• Filter feed by source, refresh on demand, paginate with m
• Config file at ~/.grokfeed/config.toml — created automatically on first run

Install

Homebrew (macOS/Linux)

brew tap emarkou/grokfeed
brew install grokfeed

pip

pip install grokfeed

pipx (isolated install)

pipx install grokfeed

From source

Requires Python 3.11+.

git clone https://github.com/emarkou/grokfeed.git
cd grokfeed
pip install -e .

---

On first run, a config file is created at ~/.grokfeed/config.toml. Edit it to change subreddits:

nano ~/.grokfeed/config.toml

subreddits = ["programming", "ClaudeAI", "machinelearning"]
hn_story_count = 30
reddit_post_count = 15
lobsters_post_count = 25
cache_ttl_minutes = 10

Run grokfeed — changes take effect on next launch or press r to refresh.

Demo

Key bindings

Main feed

Key	Action
j / ↓	Move down
k / ↑	Move up
Enter	Open post + comments split view
f	Cycle source filter (All → HN → r/sub → lobste.rs → …)
m	Load more stories
r	Refresh all sources
q	Quit

Split view

Key	Action
j / ↓	Scroll down
k / ↑	Scroll up
Tab	Switch between post and comments pane
o	Open URL in browser
q / Esc	Close

Config

~/.grokfeed/config.toml — created on first run with defaults.

Key	Default	Description
subreddits	["programming", "python", "machinelearning"]	Subreddits to include
hn_story_count	30	HN stories per fetch
reddit_post_count	15	Posts per subreddit per fetch
lobsters_post_count	25	lobste.rs posts per fetch
cache_ttl_minutes	10	Minutes before refreshing cache

Tech stack

Library	Role
Textual	TUI framework
httpx	Async HTTP client
Click	CLI entry point

---

Related posts:

• https://dev.to/elemar/building-a-terminal-feed-reader-for-hacker-news-reddit-and-lobsters-with-python-textual-2alf