{"id":13471503,"url":"https://github.com/bensadeh/circumflex","last_synced_at":"2026-05-30T12:00:28.245Z","repository":{"id":37532986,"uuid":"283105657","full_name":"bensadeh/circumflex","owner":"bensadeh","description":"🌿 It's Hacker News in your terminal","archived":false,"fork":false,"pushed_at":"2026-05-25T15:28:16.000Z","size":44150,"stargazers_count":2002,"open_issues_count":2,"forks_count":45,"subscribers_count":8,"default_branch":"main","last_synced_at":"2026-05-30T05:22:04.621Z","etag":null,"topics":["cli","client","command-line","console","hacker","hacker-news","hackernews","news","reader","terminal","tui","ycombinator"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bensadeh.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2020-07-28T05:08:10.000Z","updated_at":"2026-05-29T07:39:16.000Z","dependencies_parsed_at":"2025-11-27T12:05:44.299Z","dependency_job_id":null,"html_url":"https://github.com/bensadeh/circumflex","commit_stats":{"total_commits":2236,"total_committers":7,"mean_commits":"319.42857142857144","dds":0.04338103756708411,"last_synced_commit":"562310101e3733c4f7b38ff97dd535a90aa64c6c"},"previous_names":[],"tags_count":87,"template":false,"template_full_name":null,"purl":"pkg:github/bensadeh/circumflex","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bensadeh%2Fcircumflex","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bensadeh%2Fcircumflex/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bensadeh%2Fcircumflex/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bensadeh%2Fcircumflex/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bensadeh","download_url":"https://codeload.github.com/bensadeh/circumflex/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bensadeh%2Fcircumflex/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33691312,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-05-30T02:00:06.278Z","response_time":92,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cli","client","command-line","console","hacker","hacker-news","hackernews","news","reader","terminal","tui","ycombinator"],"created_at":"2024-07-31T16:00:45.918Z","updated_at":"2026-05-30T12:00:28.231Z","avatar_url":"https://github.com/bensadeh.png","language":"Go","funding_links":[],"categories":["Go","Apps","Clients","cli","Applications"],"sub_categories":["Command Line","CLI \u0026 TUI","RSS, News and Weather"],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"screenshots/clx.png\" width=\"150\" alt=\"circumflex\"/\u003e\n\u003c/p\u003e\n\n#\n\n\u003cp align=\"center\"\u003e\n  \u003ccode\u003ecircumflex\u003c/code\u003e is a command line tool for browsing Hacker\u0026nbsp;News in your terminal\n\u003c/p\u003e\n\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"screenshots/main_view.png\" width=\"600\" alt=\"Main view\"/\u003e\n\u003c/p\u003e\n\n### Main features\n\n- 🛋 **Everything in one place** — read both the comment section and articles in Reader Mode\n- 🌈 **Syntax highlighting** — syntax-aware formatting for comments and headlines\n- ⚡️ **Vim-style navigation** — scroll through, jump between and collapse threads with familiar keybindings\n\n**You might also like:**\n\n- 🤹 **Native terminal colors** — you bring your own color scheme, `circumflex` does the rest\n- 💎 **Nerd Fonts** — full support for Nerd Fonts as icons\n- ❤️ **Add to favorites** — save interesting submissions for later\n\n## Installing\n\nThe binary name for `circumflex` is `clx`.\n\n```console\n# Homebrew\nbrew install circumflex\n\n# Nix\nnix-shell -p circumflex\n\n# AUR\nyay -S circumflex\n\n# Go\ngo install github.com/bensadeh/circumflex/cmd/clx@latest\n\n# From source\ngo run ./cmd/clx\n```\n\n## Features\n\n### Categories\n\nSwitch between categories with \u003ckbd\u003eTab\u003c/kbd\u003e. The header shows `top`, `best`, `ask`, `show` and `favorites` by\ndefault. Pick which ones appear (and in what order) with the `--categories` flag:\n\n```console\nclx --categories top,new,best\n```\n\nAvailable categories are `top`, `best`, `new`, `ask`, `show` and `favorites`.\n\n### Comment section\n\nPress \u003ckbd\u003eEnter\u003c/kbd\u003e to view the comment section.\n\nThe comment section has two modes: `read mode` and `navigate mode`.\n\nIn `read mode`, you can scroll using the usual vim bindings. You can also jump between top-level\ncomments (\u003ckbd\u003en\u003c/kbd\u003e/\u003ckbd\u003eN\u003c/kbd\u003e), and you can expand and collapse threads by quote level\n(\u003ckbd\u003eh\u003c/kbd\u003e/\u003ckbd\u003el\u003c/kbd\u003e) or all at once (\u003ckbd\u003eEnter\u003c/kbd\u003e).\n\nIn `navigate mode`, you can individually select comments and collapse specific threads. This is useful in longer threads\nwith many replies.\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"screenshots/comment_view.png\" width=\"500\" alt=\"comment section\"/\u003e\n\u003c/p\u003e\n\n\n`circumflex` is read-only and does not support logging in, voting or commenting.\n\n### Reader Mode\n\nPress \u003ckbd\u003eSpace\u003c/kbd\u003e to read the linked article in Reader Mode. Just like in the comment section, you can jump between\nheaders using \u003ckbd\u003en\u003c/kbd\u003e/\u003ckbd\u003eN\u003c/kbd\u003e, and you can scroll using the usual vim bindings.\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"screenshots/reader_mode.png\" width=\"500\" alt=\"reader mode\"/\u003e\n\u003c/p\u003e\n\n### Favorites\n\nPress \u003ckbd\u003ef\u003c/kbd\u003e to add the highlighted submission to your favorites. Remove it with \u003ckbd\u003ex\u003c/kbd\u003e.\n\nYou can also add a submission by `ID` from the command line:\n\n```console\nclx add [id]\n```\n\nFavorites are stored in `~/.config/circumflex/favorites.json` and pretty-printed to be human-readable and VCS-friendly.\n\n### History\n\nVisited submissions are marked as read, and comments added since your last visit are highlighted.\n\nHistory is stored in `~/.cache/circumflex/history.json`. Disable tracking with `-d`/`--disable-history`, or clear it\nwith:\n\n```console\nclx clear\n```\n\n### Theme\n\n`circumflex` uses your terminal's color scheme by default. To customize, write out the default config and edit it:\n\n```console\nclx default-theme\n```\n\nThe theme lives at `~/.config/circumflex/theme.toml` and accepts named colors, hex codes, and ANSI 256 values.\n\n## Keymaps\n\nMain view keybindings — press \u003ckbd\u003ei\u003c/kbd\u003e in any view for the full list, including comment and reader mode.\n\n| Key              | Action                   |\n|:-----------------|:-------------------------|\n| \u003ckbd\u003eEnter\u003c/kbd\u003e | View comments            |\n| \u003ckbd\u003eSpace\u003c/kbd\u003e | Reader Mode              |\n| \u003ckbd\u003eTab\u003c/kbd\u003e   | Next category            |\n| \u003ckbd\u003er\u003c/kbd\u003e     | Refresh stories          |\n| \u003ckbd\u003eo\u003c/kbd\u003e     | Open story in browser    |\n| \u003ckbd\u003ec\u003c/kbd\u003e     | Open comments in browser |\n| \u003ckbd\u003ef\u003c/kbd\u003e     | Add to favorites         |\n| \u003ckbd\u003ex\u003c/kbd\u003e     | Remove from favorites    |\n| \u003ckbd\u003eu\u003c/kbd\u003e     | Toggle read              |\n| \u003ckbd\u003eq\u003c/kbd\u003e     | Quit                     |\n\n## Usage\n\nRun `clx help` or `man clx` for a full list of available commands and flags.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbensadeh%2Fcircumflex","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbensadeh%2Fcircumflex","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbensadeh%2Fcircumflex/lists"}