Skip to main content

An terminal CLI env for Hacker News

Project description


pip install hnterminal

This CLI tool supports browsing, login, upvote and commenting for full HN experience in the terminal.

Built on top of HN API and replbuilder.


pip install hnterminal

$ hnterminal will invoke the terminal command from shell, if pip installation is in your PATH

You may also run python src/ off current repository.


The CLI and each of its command have detailed help sections that you can utilize:


You can quickly navigate the front page:


Login and upvote what you like using pointers:


get_tree use DFS to create a comment tree, you can use this command on any pointer shown. Additionally, -1 pointer is reserved for parent, so you can trace a comment all the way up.


Same command used on comments:


You can reply to story or comments utilizing the same pointer, even using an editor to craft your response:



The comment will then show up (the read API will take ~30 seconds to be up to date):


This terminal tool is responsive! and the output will be adjusted to the width of the terminal for everything it displays

responsive browsing

You can also use aliases to shorten most used, repetitive commands:


There are more to this tool, for instance, it has the capability to show user info and history, it enables seamless browsing experience by maintaining a cache which status you can check with cache commands, which you may want to clear from time to time to keep it from going stale if you spend hours in this tool. The ultimate goal is to provide the same HN browsing experience in the terminal.

Usage (No Image)

See a textual demo (color and styles not available via markdown):

aperocky@~$ hnterminal
hnterminal > get_front_page -n 5
POINTER | AUTHOR                   | SCORE | COMMENT | AGE        | BASE URL
1       | Apple: Transformer architecture optimized for Apple Silicon
        | behnamoh                 | 330   | 134     | 3 hours    |
2       | You can't tell people anything (2004)
        | alexslobodnik            | 131   | 53      | 3 hours    |
3       | ChatGPT Plugins
        | bryanh                   | 1393  | 754     | 8 hours    |
4       | Relativity Space launches first 3D-printed rocket on historic test flight
        | Stevvo                   | 186   | 90      | 9 hours    |
5       | I Bought Back My Acquihired Startup
        | mokkol                   | 137   | 41      | 4 hours    |

hnterminal > login USERNAME PASSWORD
Successfully logged in as USERNAME

hnterminal > upvote 4

hnterminal > get_tree 4
Relativity Space launches first 3D-printed rocket on historic test flight
2023-03-23 12:28:25
AUTHOR: Stevvo
1                   | honestly the most impressive part of relativity space is how young their founder is.
croatiancoder       | 
2023-03-23 12:35:58 | 

2 [UPVOTED]               | Jordan was 22 when they started!!
jessfraz                  | 
2023-03-23 15:14:19       | 

3                               | Damn he’s my age and I’m still a startup engineer while he’s leading rocket
robopsychology                  | engineering lol - what a person!
2023-03-23 18:56:21             | 

4                               | How does a 22 year old get the funding to start something like this?
AnimalMuppet                    | 
2023-03-23 15:53:02             | 

hnterminal > reply_to 1 -e
... opens vim editor ...

"... whatever you wrote ..."
Comment Published

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

hnterminal-0.7.0.tar.gz (12.6 kB view hashes)

Uploaded source

Built Distribution

hnterminal-0.7.0-py3-none-any.whl (15.2 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page