hn

Hacker News · in your terminal

Read Hacker News
without leaving the terminal.

An interactive terminal browser, a scriptable CLI, and structured JSON for agents. One Rust binary for macOS and Linux.

Install hn Latest release
01

Install

brew install kaushalvivek/tap/hn

Homebrew · Apple Silicon and Intel

Native packages: .deb · .rpm · .pkg.tar.zst · .apk

The hn terminal interface showing a feed sidebar, story list, and threaded comments

feeds · threads · search · composer · drafts

02

Built for the terminal

Read

Front page, Ask, Show, jobs, search, users, comments, and full threads.

Write

Vote, submit, comment, edit, favorite, hide, and flag without leaving the TUI.

Script

Every command speaks JSON. Pipe it into jq, a dashboard, or another agent.

Belong

Static Linux binaries, native packages, Homebrew on macOS, and a tiny man page.

03

One binary, three surfaces

$ hn
front · new · best · ask · show · jobs · active · comments

$ hn thread 8863
32 comments · loaded in full

$ hn search "rust async" --sort date
SearchResults · page 1 of 62

$ hn front --limit 5 --json | jq -r '.entries[] | .title'
Llama-modchip: 284B DeepSeek on 64GB RAM, no GPU
The Reconstruction of Torn Documents
Writing as a thinking tool

hn opens the browser. hn front is line-oriented. --json is everywhere.

Command reference

04

Agent-readable

Run hn capabilities for the machine-readable contract: commands, arguments, auth requirements, output types, and error codes.

AGENTS.md llms.txt
hn capabilities | jq

Open source · MIT

Hacker News, closer to your cursor.

Install hn Star on GitHub