Back to directory

hn-cli

In a curated listMaintenance: Active

heartleo/hn-cli

Blazing fast, Hacker News CLI (TUI)⚡

View on GitHubHomepage
$ dsh plugin --profile <name> add -w dsh-hacker-news

51

stars

2

forks

Go

Language

MIT

License

2026-04-15

Created

2026-08-27

Last push

MIT-licensed Go project whose DeepSeek Harness plugin (dsh-hacker-news) brings Hacker News browsing and search into your agent via the public HN APIs — no key, no terminal client.

DSH integration

Native runtime

Author-claimed

Safety audit

Unaudited

Last verified

2026-09-01

License

MIT

01What can it help you accomplish?

  • Browse and search Hacker News from inside DeepSeek Harness without an API key

    Ranked feeds (top/new/best/ask/show/job), individual items with their reply tree, Algolia search results, and user profiles, returned through the hn_stories / hn_item / hn_search / hn_user tools

    DeepSeek Harness users who want Hacker News reading and search as part of their agent workflow

02How to install into DeepSeek Harness

Installation steps

  1. 01

    Install from npm into a profile: `dsh plugin --profile <name> add -w dsh-hacker-news`

    $ dsh plugin --profile <name> add -w dsh-hacker-news

  2. 02

    Or install from source (tracks the repo's main branch): `dsh plugin --profile <name> add -w github:heartleo/hn-cli#path:/plugins/hacker-news`

    $ dsh plugin --profile <name> add -w github:heartleo/hn-cli#path:/plugins/hacker-news

  3. 03

    Start or restart the profile so the plugin is composed into the configuration

Verify the integration

  • Run `dsh --profile <name> --dump-config` and confirm the output includes `dsh-hacker-news`
  • Ask the agent naturally, e.g. `what's popular on HN?`, `search HN for sqlite`, or `read HN item 49322107 and summarize the discussion`

03DSH integration and capability boundaries

DSH integrationNative runtime

Native DSH plugin loaded via `dsh plugin add` into a pnpm workspace profile; reads public Hacker News APIs directly (no key, no local client)

  • Ranked Hacker News feeds (hn_stories)

    a natural request such as 'what's popular on HN?'→top / new / best / ask / show / job ranked feeds

  • Item with reply tree (hn_item)

    an HN item id→the item plus its reply tree in reading order

  • Algolia search (hn_search)

    a search query→Algolia search results, by relevance or date

  • User profiles (hn_user)

    an HN username→karma, account age, bio, and submission count

04Who is it for? When not to use it?

Good for

  • DeepSeek Harness users who want Hacker News reading and search as part of their agent workflow

05Compatibility, maintenance and safety notes

2026-04-152026-08-27v0.0.6

MIT · maintained in spare time per README; latest release v0.0.6 (2026-04-27), last push 2026-08-27

06Frequently asked questions

How do I install the hn-cli DeepSeek Harness plugin?

Add the published package into a dsh profile: `dsh plugin --profile <name> add -w dsh-hacker-news`. To track the repo's main branch, use `dsh plugin --profile <name> add -w github:heartleo/hn-cli#path:/plugins/hacker-news`.

Do I need an Hacker News API key?

No. The hacker-news plugin reads the public Hacker News APIs directly and needs neither an HN API key nor a local terminal client.

How do I confirm it installed correctly?

Restart the profile, then run `dsh --profile <name> --dump-config` and check that `dsh-hacker-news` appears in the composed configuration. You can also just ask `what's popular on HN?`.

What tools does the plugin expose?

hn_stories (ranked feeds: top/new/best/ask/show/job), hn_item (an item with its reply tree), hn_search (Algolia search by relevance or date), and hn_user (karma, account age, bio, submission count).

Is the hn-cli TUI required to use the plugin?

No. The DeepSeek Harness plugin is standalone — it calls the public HN APIs itself. The hn terminal client is a separate, optional way to browse HN.

anysearch-dsh

by anysearch-team

AnySearch web search provider and advanced search tools for DeepSeek Harness (DSH)

CuratedEvaluatedWeb & BrowserTypeScript
70517

dsh-find-plugin

by awesome-dsh-plugin

In-agent plugin discovery: live GitHub repository search scoped to the official `dsh-plugin` topic, star-ranked; every result comes with a ready-to-run `dsh plugin add` command.

CuratedEvaluatedWeb & BrowserJavaScript
23814

fnos-dsh

by fnosp

Multi-source web search and fetch failover for DeepSeek Harness sessions: takes over the session searchProvider and fetchProvider seams and tries configured sources in a chosen order — TinyFish, Tavily and the official search as a fallback that always participates and can be repositioned but not removed. Multiple API keys per platform are spread round-robin, usage snapshots drive pre-flight exclusion of exhausted accounts, and per-request timeouts plus same-platform retry control failover granularity. Web fetching runs local HTTP first, then falls back to TinyFish Fetch server-side rendering and Tavily Extract, so pages still load when local egress is blocked by proxy or DNS policies. A per-platform panel shows key usage and plan limits. Install from npm with `dsh plugin --profile web add @tnnevol/dsh-failover-search`.

CuratedEvaluatedWeb & BrowserTypeScript
12012

modsearch

by liustack

Web/X 搜索与抓取桥:为纯文本 coding agent 提供结构化 JSON 证据(search/fetch/citations),引擎可选 Antigravity CLI(免 key)/带 key 引擎/X(Grok Build 登录态)。

CuratedEvaluatedWeb & BrowserTypeScript
1,02643

08Data and sources

  • Author-claimedgithub.com682f99354aed…

    For [DeepSeek Harness](https://deepseek-harness.github.io/deepseek-harness/) there is [**hacker-news**](plugins/hacker-n…

  • Author-claimedgithub.com682f99354aed…

    The published package is [`dsh-hacker-news`](https://www.npmjs.com/package/dsh-hacker-news).

  • Author-claimedgithub.com682f99354aed…

    dsh plugin --profile <name> add -w dsh-hacker-news

This page is generated from the project’s public documentation, repository metadata and a structured parse of DSH Plugins; last verified on 2026-09-01. Found an error? Submit a correction.

🏆

Best DeepSeek Harness Plugins

Twelve plugins worth installing first — picked from the whole catalog, across every category.

DSH Plugins is an independent community directory of DeepSeek Harness plugins. Not affiliated with or endorsed by DeepSeek. Third-party plugins are not security-audited — review the source before installing.

New DeepSeek Harness plugins, weekly. No spam.