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
- 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
- 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
- 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
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
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.
07Related DSH workflows
last30days-skill-cn
by jesseovo
AI agent skill that searches China's eight major platforms for the last 30 days of content and compiles a well-sourced research report.
browser4
by platonai
Browser4 — an AI-native browser engine for autonomous agents, intelligent extraction, and large-scale web automation.
modsearch
by liustack
Web/X 搜索与抓取桥：为纯文本 coding agent 提供结构化 JSON 证据（search/fetch/citations），引擎可选 Antigravity CLI（免 key）/带 key 引擎/X（Grok Build 登录态）。
anysearch-dsh
by anysearch-team
AnySearch web search provider and advanced search tools for DeepSeek Harness (DSH)
08Data and sources
For [DeepSeek Harness](https://deepseek-harness.github.io/deepseek-harness/) there is [**hacker-news**](plugins/hacker-n…
The published package is [`dsh-hacker-news`](https://www.npmjs.com/package/dsh-hacker-news).
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.