hn — Hacker News CLI

What it does

hn provides a lightweight command-line interface and optional interactive text UI (TUI) for reading Hacker News directly from the terminal. It supports listing top, new, best, ask, show, and jobs stories (with a configurable number of results), viewing individual threads with nested comments, and searching Hacker News through Algolia. The project is packaged as a Homebrew formula for easy installation on macOS and compatible systems.

When to use it

Use hn when you prefer a keyboard-driven, distraction-free Hacker News experience without opening a browser. It is ideal for developers who spend time in terminals, remote sessions, or who want a fast way to skim headlines, dive into comment threads, or perform quick searches while working. The interactive mode is suited for exploration; the CLI flags are convenient for scripting or quick one-off queries.

What's included

• Scripts: packaged as a Homebrew formula (install via brew).
• References: README and SKILL.md include install instructions and CLI flags.
• Instructions: how to install with Homebrew and the available CLI options (top/new/best/ask/show/jobs, thread, search, interactive).

Compatible agents

This skill is a plain CLI tool and thus works well with agent workflows that can call external commands or recommend local installs (e.g., Copilot/Codex style agents that provide shell instructions).