dsh-homepage
English | 简体中文
dsh-homepage gives DSH one place to browse and enter its auxiliary features. It adds an
extra surface to DSH that presents different content as cards, and a card expands to offer
entry points to those features — reviewing and installing an external plugin through a
delegated session, checking the DSH core version and updating it in one click, seeing
whether sessions are running, managing local Skills, and more. The cards are modular by
design, so any external plugin can register its own; their artwork, layout and motion can
all be customized into a personal home page.
The Home wall
Install
Installing through npm is recommended:
dsh plugin --profile web add dsh-homepage
You can also give a DSH session the address of this repository and ask the agent to
complete the installation.
Requirements
- Node.js >= 22.19
- DSH 0.2.x
Cards
Eleven cards ship: the preview shows the readings, expanding opens the full view. Click a
card to float it over the wall, drag its title to reorder, and use Customize for
artwork, visibility and motion.
| Card | What it does |
|---|
| Plugin audit | Runs a session to review a given plugin for security. It can be asked to install automatically after a passing review, or to return the review report only. |
| Sessions | How many sessions are running, waiting on you or unread, each with a shortcut into it. |
| Projects | Every workspace's branch, dirty count, ahead/behind, last commit, session count and extra worktrees. |
| Tool usage | Tool call counts, error rate, argument and output volume, estimated tokens and time, filterable by project. |
| Token usage | Balance and today's spend, with history, wallets, bonus credit and account links. |
| Network | A quick view of the DSH core's network environment variables. |
| Device | CPU, memory, GPU/VRAM and disk. |
| DSH storage | The DSH home's size, what is reclaimable, the largest categories and old-log cleanup. |
| DSH core | The latest version in the DSH repository against the installed core, with a one-click update. |
| Workspace groups | Manage the sidebar groups. |
| Skills | Browse and manage installed Skills, and discover and install community Skills. |
Extending the cards
Any other plugin can add cards through the interface. The full interface documentation is
in docs/card-api.md.
Model-facing tool
The plugin provides a model-callable homepage tool that reads the same data as the cards.
It is off by default and has to be turned on manually in the plugin's settings on the
Plugins page. Enabling the tool injects its context into a session: the tool can reach the
information of every card, including cards implemented by external plugins, and depending
on a card's implementation that may hand the agent information it did not expect.
Storage
The plugin stores its data under <DSH_HOME>/storages/dsh-homepage. <DSH_HOME> prefers
the DSH_HOME environment variable; when that variable is absent, ~/.dsh is used.
Contributing
Issues and pull requests are welcome. The development loop, the repository layout and the
checks a change has to pass are in CONTRIBUTING.md.
License
MIT — see LICENSE. Copyright (c) 2026 Yutong Zou.
