hackernews

Hacker News

CLI tool for the Hacker News API. No authentication required.

CLI Usage

Run scripts/hn.sh <command>. All commands support --json for raw JSON output.

Browse Stories

# Top/trending stories (default 10)
scripts/hn.sh top
scripts/hn.sh top --limit 20

# Other lists
scripts/hn.sh new --limit 5     # newest
scripts/hn.sh best --limit 10   # highest rated
scripts/hn.sh ask                # Ask HN
scripts/hn.sh show               # Show HN
scripts/hn.sh jobs               # job postings

View Item Details & Comments

# Full item details (story, comment, job, poll)
scripts/hn.sh item 12345678

# Top comments on a story
scripts/hn.sh comments 12345678
scripts/hn.sh comments 12345678 --limit 10 --depth 2

User Profiles

scripts/hn.sh user dang

Search

# Basic search
scripts/hn.sh search "rust programming"

# With filters
scripts/hn.sh search "LLM" --type story --sort date --period week --limit 5
scripts/hn.sh search "hiring remote" --type comment --period month

Who is Hiring

# Latest "Who is hiring?" job postings
scripts/hn.sh whoishiring
scripts/hn.sh whoishiring --limit 20

Common Workflows

User asks	Command
"What's trending on HN?"	scripts/hn.sh top
"Latest Ask HN posts"	scripts/hn.sh ask
"Search HN for X"	scripts/hn.sh search "X"
"Show me comments on story Y"	scripts/hn.sh comments Y
"Who is hiring?"	scripts/hn.sh whoishiring
"Tell me about HN user Z"	scripts/hn.sh user Z

Notes

• Story lists use parallel fetching for speed
• HTML in comments/bios is auto-converted to plain text
• Timestamps shown as relative time ("2h ago", "3d ago")
• For API details, see references/api.md