A fast, keyboard-driven Hacker News client with an optional feed that learns what you read
Browse the feeds, read and reply to threads, and sign in to vote and submit.
Open the client and read Hacker News, no account needed.
- Read every HN feed: Top, New, Show HN, Ask HN, and Jobs, switchable from the feed tabs.
- Open a story: the article and the full comment thread, with the keyboard for moving between stories.
- Turn on For you: an optional personalized feed that reorders stories from your reading habits (dwell time, opens, votes) using an on-device model of time decay, topic and domain affinity, and diversity spacing.
- Sign in with your HN account: upvote, comment, and submit without leaving the app.
- Like and bookmark: save stories to read or revisit later.
- Search: full-text story search over the Algolia HN index, with recent-search history.
Navigation and action keys (J, K, O, C, L, B, R) work while you are reading a story. Feed tab keys (1–5) work on the News list.
| Key | Action |
|---|---|
J / K | Next or previous post (while reading) |
O | Open the link |
C | Open on Hacker News |
L / B | Like or bookmark the post |
R | Reply to the post |
1 to 5 | Top, New, Show, Ask, Jobs |
G then H / F / L / B | Home, For you, Likes, Bookmarks |
/ | Open search |
Cmd+K | Command menu |
Cmd+/ | Show all shortcuts |
Cmd+B | Toggle the sidebar |
Esc | Back to the list (when you opened a story from a feed) |
On Windows and Linux, use Ctrl where the table says Cmd.
Your reading history, likes, bookmarks, and the signals that power For you live in the browser (IndexedDB). Recent searches live in localStorage. That data stays on your device. Story and comment text comes from the public Hacker News APIs. HN sign-in sends your credentials to this app's server so it can vote, comment, and submit on your behalf; the session is stored in an encrypted cookie.
npm install
npm run devTo enable upvoting, commenting, and submitting locally, set a session secret and restart the dev server:
echo"HN_SESSION_SECRET=$(openssl rand -hex 32)">> .env.localWithout HN_SESSION_SECRET, the app runs read-only. Run tests with npm run test (Vitest). See AGENTS.md for lint/format commands, the full script list, and how to refresh the For you candidate corpus.
MIT
Crafted by 