Ochi is a simple CLI to navigate Hacker News in the terminal made with the Textualize/rich and pallets/click packages. In the future, when the awesome Textualize/textual package launches its documentation I will update this project with a complete TUI.

ochi is hosted on PyPi. So you can install it with:

pip install ochi

Or install it from its GitHub repository:

pip install git+https://github.com/daniarlert/ochi.git

Note that you may need to run pip3 instead of pip or use python -m depending on your setup.

The most simple way to start using ochi is by just running:

ochi

To see all the flags ochi has available, use the --help flag.

By default, ochi fetchs and displays the latest 500 stories on the selected category which in this case is top (topstories). So a better way to start may be:

ochi --max 10

# Or

ochi -m 10

To get stories from other categories just use the -c or --category flag:

ochi --category new

# Or

ochi -m 10 -c job

You can order stories by its ID, Score or posted date and reverse its order if you want to:

ochi -m 10 --order-by date

# Or

ochi -m 10 --order-by date --reverse

• Bookmarks/save stories.
• Configuration for colorschemes and defaults.
• View post with comments.
• View user profile.