Home

Awesome

<p align="center"> <img src="screenshots/clx.png" width="150" alt="circumflex"/> </p>

<p align="center"> <code>circumflex</code> is a command line tool for browsing Hacker&nbsp;News in your terminal </p> <p align="center"> <img src="screenshots/mainview.png" width="700" alt="^"/> </p>

Main features

You might also like:

Table of Contents

Installing

The binary name for circumflex is clx.

Package managers

# Homebrew
brew install circumflex

# Nix
nix-shell -p circumflex

# AUR
yay -S circumflex

From source

# Go
go run main.go

[!IMPORTANT] When building from source, make sure that you are using the latest version of less.

Comment section

Overview

Press <kbd>Enter</kbd> to read the comment section.

<p align="center"> <img src="screenshots/comment_view.png" width="500" alt="^"/> </p>

Comments are pretty-printed and piped to the pager less. To present a nice and readable comment section, circumflex features:

Navigation

The following pair of shortcuts are recommended for browsing and navigating the comment section.

Reader mode

Press <kbd>Space</kbd> to read the submission link in Reader Mode.

<p align="center"> <img src="screenshots/reader_mode.png" width="500" alt="^"/> </p>

[!NOTE] Some websites do not work well with Reader Mode. If the submission URL points to a domain with known Reader Mode incompatibility, the link cannot be opened in Reader Mode.

Syntax highlighting

Quotes

Quotes are indented, italicized and dimmed in order to distinguish them from the rest of the comment.

<p align="center"> <img src="screenshots/quotes.png" width="800" alt="^"/> </p>

Hacker News and forum idiosyncrasies

`Code snippets`, @username mentions, $variables and URLs are highlighted.

<p align="center"> <img src="screenshots/commentSyntax.png" width="700" alt="^"/> </p>

References

References on Hacker News are formatted as numbers inside brackets. circumflex highlights these numbers for easier cross-referencing.

<p align="center"> <img src="screenshots/linkHighlights.png" width="500" alt="^"/> </p>

Categories

Headlines containing the text Ask HN, Tell HN, Show HN and Launch HN are highlighted.

<p align="center"> <img src="screenshots/showtell.png" width="250" alt="^"/> </p>

YC-funded startups

Twice a year, Y Combinator funds start-ups through its accelerator program. circumflex highlights these startups to signalize their affiliation with YC.

<p align="center"> <img src="screenshots/yc.png" width="350" alt="^"/> </p>

Nerd Fonts

If you have a Nerd Fonts-patched fonts, you can run clx with the -n or --nerdfonts flag.

<p align="center"> <img src="screenshots/nerd-fonts-1.png" width="650"/> </p> <p align="center"> <img src="screenshots/nerd-fonts-2.png" width="650"/> </p>

History

Mark submissions as read

Visited submissions are marked as read.

<p align="center"> <img src="screenshots/mark_article_as_read.png" width="800"/> </p>

Highlight new comments

Comments that are new since the last visit are highlighted.

<p align="center"> <img src="screenshots/mark_new_comments.png" width="400"/> </p>

Disabling history

A list of submissions (by ID and last time visited) are stored in ~/.cache/circumflex/history.json. Disable marking submissions as read by running clx with the -d or --disable-history flag.

You can delete your browsing history from the command line:

clx clear

Favorites

Press <kbd>f</kbd> to add the currently highlighted submission to your list of favorites. Remove submissions from the Favorites page with <kbd>x</kbd>.

You can add any submission by its ID from the command line:

clx add [id]

Favorites are stored in ~/.config/circumflex/favorites.json. circumflex pretty-prints favorites.json to make it both human-readable and VCS-friendly.

Settings

Overview

Run clx help or man clx for a list of available commands and settings.

Commands

add [ID]      Add item to list of favorites by ID
comments [ID] Go directly to the comment section by ID
article [ID]  Read the linked article associated with an item based on the ID
url [URL]     Open a URL directly in Reader Mode
clear         Clear the history of visited IDs

Flags

-a, --auto-expand           Automatically expand all replies upon entering
                              the comment section
    --categories=[string]   Set the categories in the header
                              (available: "top,best,ask,show,new")
                              (default:   "top,best,ask,show")
-c, --comment-width=[int]   Set the comment width 
                              (default 70)
-e, --disable-emojis        Disable conversion of smileys to emojis
-d, --disable-history       Disable marking stories as read
-t, --hide-indent           Hide the indentation bar to the left of the reply
-n, --nerdfonts             Enable Nerd Fonts
    --no-less-verify        Disable checking less version on startup
-o, --plain-comments        Disable syntax highlighting for comments
-p, --plain-headlines       Disable syntax highlighting for headlines
-v, --version               Print current version

Keymaps

Press <kbd>?</kbd>/<kbd>i</kbd> to show a list of available keymaps:

KeyDescription
<kbd>Enter</kbd>Read comments
<kbd>Space</kbd>Read article in Reader Mode
<kbd>r</kbd>Refresh
<kbd>Tab</kbd>Change category
<kbd>o</kbd>Open link to article in browser
<kbd>c</kbd>Open comment section in browser
<kbd>f</kbd>Add to favorites
<kbd>x</kbd>Remove from favorites
<kbd>q</kbd>Quit

Under the hood

circumflex uses:

Screenshots use: