bill9109/dsh-101
30Last commit Aug 14, 2026
dsh-101 DSH plugin
dsh-101 is a document-first reading interface built on top of dsh-base and dsh-web-app. It curates DSH's built-in documentation into an ordered, searchable, and translatable reader, with a sliding table of contents and a conversation panel on the right. It runs as a standalone profile on port 3081, coexisting with the web GUI on 3080.
How to install the dsh-101 DSH plugin
dsh plugin --profile dsh-101 add github:bill9109/dsh-101#v0.1.7Copying does not run this command. Review the repository and version before installing the dsh-101 DSH plugin.
dsh-101 DSH plugin data source
dsh-101 DSH plugin snapshot date: Aug 16, 2026
discovered
What the dsh-101 DSH plugin can do
- Curated and ordered DSH built-in documentation by topic
- Built-in document translation
- Sliding hidden table of contents
- Conversation panel on the right for asking questions while reading
- Search filtering of documents
Where the dsh-101 DSH plugin fits
- Reading and browsing DSH's official documentation in a structured way
- Asking questions about documentation content while reading with the conversation panel
- Translating documentation into other languages on the fly
- Using as a standalone documentation reader alongside the main DSH web GUI
Who the dsh-101 DSH plugin is for
- DSH users who need to read and navigate DSH's documentation comfortably
- Developers who want a searchable, translatable documentation viewer integrated with DSH's conversation system
dsh-101 DSH plugin limitations
- Must not be installed into the `web` profile, as it disables the default browser shell causing the web GUI to hang
- Default port 3081 may conflict with other services; can be changed via launch flag or profile config
- Installation requires a working DSH environment (dsh-base and dsh-web-app)
- The bundle is built against a specific DSH snapshot; upgrading DSH may require syncing sources via `upgrade.mjs`
dsh-101 DSH plugin: from the repository README
Quoted from the bill9109/dsh-101 README, the upstream source of the dsh-101 DSH plugin. Copyright remains with the original authors.
**Install:** `bash <(curl -fsSL https://raw.githubusercontent.com/bill9109/dsh-101/main/scripts/install.sh) github:bill9109/dsh-101#v0.1.7` **DSH 101 is a document-first reading interface built on top of `dsh-base` + `dsh-web-app`: it organizes DSH's own documentation into an ordered, searchable, translatable reader.** [English](README.md) | [中文](README.zh.md) ## Why this exists DSH ships a large body of built-in documentation, but in its raw form it is a file dump: scattered across the source tree, with no order, no search, and no comfortable way to read it. dsh-101 makes that documentation a first-class part of the DSH experience — a curated, ordered, searchable, translatable reader instead of raw files, with the conversation panel alongside so you can ask questions while you read. ## Features - DSH's built-in documentation, curated and ordered by topic - Built-in document translation - A sliding hidden table of contents - Conversation panel on the right ## Usage Boot the profile (default port 3081, coexists with the web GUI on 3080): ```sh dsh --profile dsh-101 ``` Open http://127.0.0.1:3081 (or the port you chose): the reader shows the curated corpus with the sliding
Read the full READMERepository license: BSD-3-Clause
dsh-101 DSH plugin questions
How do I install dsh-101?
Run the one-liner script: `bash <(curl -fsSL https://raw.githubusercontent.com/bill9109/dsh-101/main/scripts/install.sh) github:bill9109/dsh-101#v0.1.7`. This will place the profile into `~/.dsh/profiles/dsh-101/` and install the bundle. Then boot with `dsh --profile dsh-101`. You can also do a manual install by copying the profile files and running `dsh plugin --profile dsh-101 add github:bill9109/dsh-101#v0.1.7`.
How do I change the default port?
You can change the port at launch by passing `--port <port>` to `dsh --profile dsh-101 --port 8080`. To persist a different default, edit the profile's `cordis.patch.yml` file under `~/.dsh/profiles/dsh-101/` and set the `port` value in the webserver config. Launch flags always take precedence over the patch file.
What happens if I install dsh-101 into the web profile?
Installing dsh-101 into the `web` profile will disable `ui-layout`, the default browser shell. This causes the web GUI to hang because the sidebar, conversation, and app-shell all wait for the layout service. Always use dsh-101 as its own profile with `dsh --profile dsh-101`. The install script now rejects `--profile web` explicitly.
How do I uninstall dsh-101?
Run `dsh plugin --profile dsh-101 remove @bill9109/dsh-101` to remove the bundle. If you no longer want the standalone profile, delete the `~/.dsh/profiles/dsh-101/` directory. The first command runs `pnpm remove` and updates the bundle list; the second removes the profile directory.
How do I upgrade dsh-101 to a newer version?
Re-run the one-liner with the new pinned tag, e.g., `bash <(curl -fsSL https://raw.githubusercontent.com/bill9109/dsh-101/main/scripts/install.sh) github:bill9109/dsh-101#v0.2.0`. For a local checkout, re-run `./scripts/install.sh .` against the updated checkout. This only fills in missing layers, preserving your profile state. If DSH itself has published a new snapshot, use `node scripts/upgrade.mjs` to sync sources.