https://github.com/wcarhart/lurker

Hacker News terminal client
https://github.com/wcarhart/lurker

bash cli hacker-news ycombinator

Last synced: 3 months ago
JSON representation

Hacker News terminal client

• Host: GitHub
• URL: https://github.com/wcarhart/lurker
• Owner: wcarhart
• License: mit
• Created: 2019-07-12T01:27:52.000Z (over 5 years ago)
• Default Branch: master
• Last Pushed: 2020-10-29T17:07:03.000Z (about 4 years ago)
• Last Synced: 2024-04-07T07:35:52.168Z (7 months ago)
• Topics: bash, cli, hacker-news, ycombinator
• Language: Shell
• Size: 64.5 KB
• Stars: 6
• Watchers: 2
• Forks: 0
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-hackernews - lurker - HN terminal client. `MIT` (Clients / CLI & TUI)

README

        


lurker

Hacker News terminal client


### Overview

Lurker is a simple terminal client for reading [Hacker News](https://news.ycombinator.com/), written entirely in bash.

### Documentation

Please visit the [documentation site](https://willcarhart.dev/docs/lurker) for full documentation.

### Install

Install with [Homebrew](https://brew.sh):

```bash

brew install wcarhart/tools/lurker

```

Or, download or clone this repository and run:

```bash

./lurker

```

### Examples

Read Hacker News headlines...

![lurker demo 1](https://i.imgur.com/v6kNmTb.png)

Read comments for a specific post...

![lurker demo 2](https://i.imgur.com/n68f059.png)

### Available commands

```

> help

Available commands:

  help        - show this help menu

  read    - open the comment thread for post ID

  open    - open the URL for the post ID in your default browser (only available on macOS)

  copy    - copy the URL for the post ID to the clipboard (only available on macOS)

  hack    - open the Hacker News link for the post ID in your default browser (only available on macOS)

  smoosh  - summarize (smoosh) the content from the URL for post ID (only available on macOS)

  user    - show info for user ID

          - get info for post ID

  more        - show the next 10 posts (up to 500)

  less        - show the previous 10 posts

  back        - show the previous list of posts again

  refresh     - refresh the master post list, which will reset the ordering of posts

  clear       - clear the screen

  exit        - quit lurker

```

Learn more about [smoosh](https://github.com/wcarhart/smoosh).