{"id":23989612,"url":"https://github.com/candidtim/hnwelcome","last_synced_at":"2026-06-12T06:02:53.726Z","repository":{"id":171466680,"uuid":"647897136","full_name":"candidtim/hnwelcome","owner":"candidtim","description":"CLI application to show top Hacker News stories","archived":false,"fork":false,"pushed_at":"2023-06-01T00:14:19.000Z","size":14,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-02-25T03:42:34.954Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"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/candidtim.png","metadata":{"files":{"readme":"README.md","changelog":null,"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}},"created_at":"2023-05-31T19:01:59.000Z","updated_at":"2023-06-01T03:02:36.000Z","dependencies_parsed_at":null,"dependency_job_id":"55220347-1f92-4855-ae85-d0dcc636b206","html_url":"https://github.com/candidtim/hnwelcome","commit_stats":null,"previous_names":["candidtim/hnwelcome"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/candidtim/hnwelcome","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/candidtim%2Fhnwelcome","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/candidtim%2Fhnwelcome/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/candidtim%2Fhnwelcome/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/candidtim%2Fhnwelcome/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/candidtim","download_url":"https://codeload.github.com/candidtim/hnwelcome/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/candidtim%2Fhnwelcome/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34231212,"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-06-12T02:00:06.859Z","response_time":109,"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":[],"created_at":"2025-01-07T17:32:19.472Z","updated_at":"2026-06-12T06:02:53.692Z","avatar_url":"https://github.com/candidtim.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# HN Welcome\n\n     ___________________________________________________________________\n    / Show HN: `hnwelcome` is a CLI app to show top Hacker News stories \\\n    | https://github.com/candidtim/hnwelcome                            |\n    \\ https://news.ycombinator.com/item?id=36146152                     /\n     -------------------------------------------------------------------\n            \\   ^__^\n             \\  (oo)\\_______\n                (__)\\       )\\/\\\n                    ||----w |\n                    ||     ||\n\nA simple and fast CLI appliaction to show top\n[Hacker News](https://news.ycombinator.com/) stories in the command line. Works\nbest with [`cowsay`](https://en.wikipedia.org/wiki/Cowsay). Use it like\n[`fortune`](https://en.wikipedia.org/wiki/Fortune_(Unix))\nand tap into an endless supply of top Hacker News stories.\n\n## Installation\n\nWith Go tool chain:\n\n    $ go install github.com/candidtim/hnwelcome@1.0.1\n\nOr, download a binary for your OS from the\n[Releases](https://github.com/candidtim/hnwelcome/releases) page.\n\nIf nothing else works, clone the repository and build with `go build .`.\n\n## Usage\n\nTo see one of the top 5 stories:\n\n    $ hnwelcome\n\n    Hacking my “smart” toothbrush [467]\n    https://kuenzi.dev/toothbrush/\n    https://news.ycombinator.com/item?id=36128617\n\nOne of the newest stories:\n\n    $ hnwelcome --newest\n\nTo choose randomly between the top 10 stories (instead of the default of top 5):\n\n    $ hnwelcome -n 10\n\nPipe to `cowsay`:\n\n    $ hnwelcome | cowsay -n\n     _______________________________________________\n    / Hacking my “smart” toothbrush [467]           \\\n    | https://kuenzi.dev/toothbrush/                |\n    \\ https://news.ycombinator.com/item?id=36128617 /\n     -----------------------------------------------\n            \\   ^__^\n             \\  (oo)\\_______\n                (__)\\       )\\/\\\n                    ||----w |\n                    ||     ||\n\nSee the built-in help for more options, or read below for customization.\n\n### Show the top stories in new shell sessions\n\nIf you want to see one of the top stories every time you start a terminal, you\nmay run `hnwelcome | cowsay -n` in your shell's `.*rc` file\n(`.bashrc`, `.zshrc`).\n\n### Show the top stories in Vim on startup\n\nFor Vim users, if you want to see top HN stories in a welcome screen, my\nrecommendation is to use [vim-startify](https://github.com/mhinz/vim-startify)\nwith the following configuration:\n\n    let g:startify_custom_header = split(system('hnwelcome | cowsay -n'), '\\n')\n\n### Customize the output format\n\nTo customize the output format pass a `--template` to use for the formatting.\nThe template should use the Golang\n[template syntax](https://pkg.go.dev/text/template). Available variables are:\n`By`, `Time`, `Title`, `Score`, `Url`, `Id`. See the\n[Hacker News API documentation](https://github.com/HackerNews/API#items) for\nmore details about their values.\n\n    $ hnwelcome --template PATH\n\nFor example, to print out only the title and the author:\n\n    $ hnwelcome --template \"{{.Title}} by {{.By}}\"\n\nThe default template is:\n\n    {{.Title}} [{{.Score}}]\n    {{.Url}}\n    https://news.ycombinator.com/item?id={{.Id}}\n\n### Latency and timeout\n\nDue to the Internet connection and the API latency, `hnwelcome` may slow down\nthe shell or Vim startup time if you configure them to run it on startup. By\ndefault, `hnwelcome` will try to fetch the story in under 2 seconds, or timeout\nnicely otherwise. You can change the timeout value with a `--timeout` argument.\nFor example, if you have a somewhat slow Internet connection and you are ready\nto wait for up to 5 seconds:\n\n    hnwelcome --timetout 5s\n\n## License\n\n[The MIT License](http://opensource.org/licenses/MIT)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcandidtim%2Fhnwelcome","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcandidtim%2Fhnwelcome","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcandidtim%2Fhnwelcome/lists"}