Hacker News tools for feeds, discussion threads, search, and user profiles.
Install
# from npm (prebuilt)
dsh plugin --profile web add dsh-hacker-news
# from GitHub (first run asks for allowBuilds approval — follow the hint, retry)
dsh plugin --profile web add github:heartleo/hn-cli#path:/plugins/hacker-news
Any plugin you install runs third-party code with your own permissions — it can read your files, use your credentials, and reach the network, and tool approvals don’t sandbox it. GitHub-sourced plugins also run build scripts at install time — pnpm blocks those until you allow them, so an install can stop with ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED or ERR_PNPM_IGNORED_BUILDS; dsh prints the exact key to add under allowBuilds in your profile’s pnpm-workspace.yaml, and the install works on the next run. Allowing a build is a trust decision: only install sources you trust, and pin a commit (github:owner/repo#sha).
README
Hacker News tools for DeepSeek Harness: browse the ranked feeds, read a thread with its reply tree, search the Algolia index, and look up a user.
The plugin is published as dsh-hacker-news and listed in the awesome-dsh-plugin community registry.
Plain ESM JavaScript, no build step and no runtime dependency on the hn binary — it talks to the public HN APIs directly (https://hacker-news.firebaseio.com/v0 and https://hn.algolia.com/api/v1).
Tools
| Tool | Arguments | Returns |
|---|---|---|
hn_stories |
feed (top/new/best/ask/show/job), limit, offset |
Ranked stories with id, score, comment count, URLs |
hn_item |
id (required), comment_limit, max_depth |
The item plus its reply tree in reading order, with depth and truncated |
hn_search |
query (required), sort (relevance/date), tags, limit |
Algolia hits normalised to the story shape |
hn_user |
id (required) |
found, karma, account age, bio, submission count |
Comment HTML is converted to plain text (links keep their label plus target) and clipped at maxTextLength. Reply loading is breadth-first, so a small comment_limit returns the top of the thread rather than one deep branch; truncated reports whether anything was left out.
Use
Ask naturally; the plugin guides the agent to the matching tool:
What's popular on Hacker News right now?
Search Hacker News for SQLite WASM.
Read HN item 49322107 and summarize the discussion.
Look up the HN user dang.
Install
Install the published package:
dsh plugin --profile <name> add -w dsh-hacker-news
Restart DSH Web after installation. If your npm mirror has not indexed the latest release, use the public npm registry for the install:
$env:npm_config_registry = 'https://registry.npmjs.org/'
dsh plugin --profile <name> add -w dsh-hacker-news
The package ships runnable JavaScript, so no prepare build and no pnpm allowBuilds entry is needed. To install directly from the repository or from a local checkout:
dsh plugin --profile <name> add -w github:heartleo/hn-cli#path:/plugins/hacker-news
dsh plugin --profile <name> add -w /absolute/path/to/hn-cli/plugins/hacker-news
dsh --profile <name> --dump-config # shows the "# == dsh-hacker-news" layer
To load it from source without installing, point a patch overlay at the entry file:
- insert:
- id: hacker-news
name: '/absolute/path/to/hn-cli/plugins/hacker-news/index.js'
pnpm dsh web --patch ./scratch/hacker-news.cordis.yml
Configuration
Every tunable is a config field, overridable per profile in cordis.patch.yml:
- id: hacker-news
name: dsh-hacker-news
config:
defaultStoryLimit: 30
defaultCommentLimit: 100
requestTimeoutMs: 20000
| Field | Default | Meaning |
|---|---|---|
firebaseBaseUrl |
https://hacker-news.firebaseio.com/v0 |
Official HN API root |
algoliaBaseUrl |
https://hn.algolia.com/api/v1 |
Search API root |
requestTimeoutMs |
15000 |
Per-request timeout |
concurrency |
20 |
Maximum in-flight item fetches |
defaultStoryLimit / maxStoryLimit |
20 / 100 |
Story and search result counts |
defaultCommentLimit / maxCommentLimit |
50 / 400 |
Replies loaded per hn_item call |
defaultCommentDepth / maxCommentDepth |
5 / 10 |
Reply nesting followed |
maxTextLength |
2000 |
Clip length for story, comment, and bio text |
userAgent |
dsh-hacker-news/0.1.0 … |
Sent on every request |
Checking it locally
npm test first runs the offline routing and presentation tests, then load-check.mjs registers the tools against a stub context, runs every tool against the live API, validates each result with the registry's own output-schema validator, and exercises the rejection paths:
cd plugins/hacker-news
npm install --no-package-lock
npm test
The final integration phase needs network access.
Links
More in this category
Tencent/WeKnora#dsh-weknora★ 37401
Four read-only tools over a WeKnora knowledge base: list knowledge bases, hybrid passage search, reassemble one document's chunks in order, and WeKnora's own cited RAG or ReAct-agent answer with a resumable session id.
DayuanJiang/next-ai-draw-io#dsh-plugin★ 36932
Draws draw.io diagrams in DeepSeek Harness through the next-ai-drawio MCP server: the link in the reply opens a live preview in the right sidebar, you can edit the diagram by hand, and each AI change is a version you can restore. Node.js 18+; npx downloads the MCP server on first use.
superdesigndev/treg★ 7929
Tool catalog for agents: search ~2,600 external endpoints (SEO and SERP, backlinks, social, people and company enrichment, ad libraries, scraping) by the task you want done, read each one's parameters and per-call price, then call it with the credential injected server-side. Ships the skill plus an MCP row that stays disabled until TREG_TOKEN is set.
T-Auto/dsh-ops★ 5798
Provides bash, PowerShell 7, and high-performance Rust tools for DSH on Windows to reduce token usage.
sixtysevenlf/dsh-blender-plugin★ 2081
Lets a DSH agent drive a local Blender over a direct TCP channel with 15 tools: viewport frames, custom-angle renders, Python execution, headless and job offload, transaction rollback, and a planning layer of 228 ops across 34 families.
yjl9903/AnimeGarden#dsh★ 1400
Anime Garden for DSH: search anime torrent resources from 動漫花園, 蜜柑计划, 萌番组 and ANi inside DSH — via chat, a sidebar panel with fansub and type filters, a seasonal calendar, and an in-app floating player.
Community comments
Comments are public GitHub Discussions. Loading them connects to GitHub and Giscus; a GitHub account is required to post.