Need help with hn-cli?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

447 Stars 22 Forks MIT License 132 Commits 5 Opened issues


:newspaper: CLI to browse Hacker News

Services available


Need anything else?

Contributors list

hn-cli Build Status

CLI to browse Hacker News



$ npm install -g @rafaelrinaldi/hn-cli


Usage: hn [OPTIONS]

CLI to browse Hacker News

Example: $ hn --limit 10 --keep-open

Options: -v --version Display current software version -h --help Display help and usage details -l --limit Limit the number of items to display (defaults to 150) -k --keep-open Wether or not to keep the list open after selecting an item (defaults to false) --latest Sort the list by submission date (defaults to false)


  • By default it will list stories using the same order as seen on HN
  • You can change the list order to display the most recent ones by runnig the program with the
  • You can use Vim arrow keys j and k to navigate through the list
  • Use gg to scroll to the first item of the list and G to scroll to the last one
  • Hitting the enter key will open the URL in your default browser
  • Hitting the c key will open the HN comments for that story on your default browser
  • Share an item on Twitter by hitting the t key
  • Hitting the r key will refresh the stories and update the current list
  • A status bar is fixed on the bottom of the screen to provide visual feedback about updates and reading progress
  • Use esc, ⌃C or q to close the program


MIT © Rafael Rinaldi

Buy me a ☕

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.