DeepDeck Hacker News Reader
A dsh-plugin Cordis Host/Client bundle that adds a focused Hacker News reader
to DeepSeek Harness.
Best used with DeepDeck. DeepDeck
supplies the Apps launcher, standalone app window, app-scoped Workspace and
canonical AI conversations used by Summarize and Explain. This plugin
expects DeepDeck's App runtime service when it is mounted.
Screenshot
Captured from the standalone DeepDeck desktop App window—not a browser tab.
Select a story to read the full discussion, then send the story, a comment, or
selected text to a dedicated DeepDeck conversation with Summarize or
Explain.
Hacker News Reader running with DeepDeck
Install with DeepDeck (recommended)
- Open Settings → Apps in DeepDeck.
- Paste
https://github.com/jo32/dsh-hackernews-reader.git into Install an
App plugin.
- Choose Inspect source, review the detected package and build command,
then choose Confirm install.
- Restart DeepDeck when prompted.
- Open Apps → Hacker News from the sidebar.
For local development, build the checkout and install the resulting local
bundle into the active DeepDeck web profile:
git clone https://github.com/jo32/dsh-hackernews-reader.git
cd dsh-hackernews-reader
pnpm install --frozen-lockfile
pnpm check && pnpm test && pnpm build
dsh plugin --profile web add "$PWD"
The last command only mounts the Cordis bundle; run it in a DeepDeck-managed
profile so the required App runtime is present.
Usage examples
- Open Top, New, Best, Ask HN, Show HN, or Jobs, then
select a story to read its complete nested discussion.
- Search for
local-first AI, switch between relevance and newest-first order,
and open any result without leaving the reader.
- Click Summarize on a story, or Explain with AI on a comment, to open a
canonical Session in
~/DeepDeck/Apps/hackernews-reader.
- Ask the DeepDeck agent:
Read today's top Hacker News stories and group them by topic. The plugin exposes read-only tools for feeds, search, stories,
users, account state and the current UI context.
Features
- Top, New, Best, Ask HN, Show HN, and Jobs feeds
- Relevance and newest-first story search
- Story, text-post, nested-comment, and user-profile reading
- Same-origin standalone desktop window
- App-scoped
hackernews_stories, hackernews_search,
hackernews_read_story, hackernews_user, and context tools
- Optional Hacker News sign-in with session verification
Authentication uses Hacker News's own login form. The password is forwarded
once to Hacker News and is never persisted; only the returned user session
cookie and public username are kept in the Harness credential store. The
reader remains read-only because the official Hacker News API does not expose
supported write endpoints.
Development
pnpm install --frozen-lockfile
pnpm check
pnpm test
pnpm build
The plugin targets DeepSeek Harness 0.1.1-rc.1. Its Host/Client entries,
types, invariant and self-mounting bundle are declared in package.json and
cordis.patch.yml; generated lib/ output is not committed.
License
MIT
