@deepdeck/dsh-hackernews-reader

Readme

# DeepDeck Hacker News Reader

[![DSH Plugin](https://img.shields.io/badge/DSH-plugin-5b21b6)](https://dshfind.com/plugins/jo32/dsh-hackernews-reader)
[![DeepDeck App](https://img.shields.io/badge/DeepDeck-App-f15a24)](https://github.com/jo32/DeepDeck)
[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)

A `dsh-plugin` Cordis Host/Client bundle that adds a focused Hacker News reader
to DeepSeek Harness.

> **Best used with [DeepDeck](https://github.com/jo32/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](docs/images/deepdeck-hackernews-reader.jpg)

## Install with DeepDeck (recommended)

1. Open **Settings → Apps** in DeepDeck.
2. Paste `https://github.com/jo32/dsh-hackernews-reader.git` into **Install an
   App plugin**.
3. Choose **Inspect source**, review the detected package and build command,
   then choose **Confirm install**.
4. Restart DeepDeck when prompted.
5. 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:

```bash
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

```bash
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