Introduction

When using DSH to run daily tasks, two small annoyances recur repeatedly: the confirmation step before tool execution, where dangerous commands must be manually reviewed—watching every single one consumes energy and carries the risk of missing one; and the waiting step, where approval requests or background tasks complete—without staring at the interface, you might easily miss them.

dsh-pi-kit targets these two points. It is a lightweight collection of optimization plugins for DSH that bundles “auto-review” and “chime” into one package. Once installed, it is basically imperceptible during daily use; dangerous operations and waiting events will no longer be missed. Below is an introduction to its functions, installation, and usage.

What is this

dsh-pi-kit is maintained by Pidreamleaves, licensed under MIT, and currently version 0.1.0. It uses a workspace to manage three member packages, mounted via a bundle mechanism in one go:

  • auto-review: Automatic review gatekeeper
  • approval-chime: Chime / Notification
  • pi-kit-settings: Consolidated settings card

Each package handles one thing, but any one of them can be installed individually.

Core Features

Auto-Review (auto-review)

Automatically handles the confirmation step before tool execution: intercepting dangerous commands, allowing safe operations, and asking the user for confirmation on ambiguous ones. The review is completed using a lightweight model that reuses DSH credentials, requiring no additional configuration for keys.

Approval Chime (approval-chime)

Uses different sounds to remind you when approval requests, questions, or background tasks are completed. When background jobs finish, it also calls system notifications. This way, even if you switch windows, you won’t miss moments that require your intervention.

Consolidated Settings Card (pi-kit-settings)

The settings for the three plugins are collected into one card. The entry point is “Settings → Plugins → Plugin Config → dsh-pi-kit,” and the configuration is stored persistently. Without installing this settings shell, the settings would appear as separate cards.

Installation and Usage

First, ensure pnpm is available in your environment (the dsh plugin command internally calls pnpm to complete the installation; if prompted with pnpm not found, run npm install -g pnpm first), then execute:

dsh plugin --profile web add dsh-pi-kit

This command reads the dsh.bundle.patch inside the package. DSH automatically completes dependency installation and mounting; you don’t need to write any patches manually. Restart DSH to apply changes.

web is the built-in Web GUI profile name. Use the corresponding name when using other profiles (the directory name under ~/.dsh/profiles/).

Manual Installation

The equivalent method is to directly modify the profile’s package.json, declaring dependencies and mounting the bundle:

{
  "dependencies": { "dsh-pi-kit": "^0.1.0" },
  "dsh": { "profile": { "bundles": ["dsh-pi-kit"] } }
}

Verification and Uninstallation

After installation, use the following command to confirm the plugin has been mounted:

dsh --profile web --dump-config

To uninstall when not needed, restart dsh web to apply:

dsh plugin --profile web remove dsh-pi-kit

  1. When the profile uses the pnpm isolated layout, member packages will be collected into a nested directory, and dsh web may throw an error Cannot find package 'dsh-auto-reviewer'. After adding nodeLinker: hoisted to the profile’s pnpm-workspace.yaml, reinstall it.

  2. To disable a specific member individually, append a line - id: <plugin id> disabled: true to the patch layer; there is no need to uninstall the whole package.

Daily Usage

After installation and restart, both features are enabled by default. You can use them immediately and adjust as needed.

Auto-Review: The review model is deepseek-v4-flash. The strategy file ~/.dsh/auto-review.yml will automatically generate a commented template on first startup; simply modify it into your own rules. At the end of each conversation turn, the review results are summarized with colored badges—Pass (Green), Block (Red), Promote (Blue). Clicking “Details” allows you to see the reasoning for each judgment.

Approval Chime: The completion sound reminds only background sessions by default to avoid frequent disturbance to normal sessions; if you want all sessions to have a chime, you can change this in the settings. The tones for approval, question, and completion sounds can all be auditioned in the settings.

Installation from Source: If you want to modify the code for debugging, you can link the three member packages to the web profile:

git clone https://github.com/Pidreamleaves/dsh-pi-kit.git
cd dsh-pi-kit
pnpm install
pnpm -r build

dsh plugin --profile web add link:<absolute-path>/dsh-pi-kit/packages/auto-review
dsh plugin --profile web add link:<absolute-path>/dsh-pi-kit/packages/approval-chime
dsh plugin --profile web add link:<absolute-path>/dsh-pi-kit/packages/pi-kit-settings

Restart dsh web to apply; after changing code, run pnpm -r build and then restart.

Use Cases and Notes

Suitable for two types of people: those who often let DSH execute commands and wish to reduce the burden of manual confirmation without giving up their security baseline; and those who are accustomed to throwing tasks to the background and need to know in time “it’s time to come back.” The two functions can be installed together or individually; do not introduce them if not needed.

There is one point to clarify before installation: this type of client plugin runs with the permissions of the current dsh process; the permissions it gets are your permissions. dsh-pi-kit is MIT-licensed and source code is open. Before installing, it is recommended to review the repository source code to confirm that the review rules and dependencies match your expectations, and then decide whether to enable it.

Conclusion

dsh-pi-kit does not do complex things: it turns these two high-frequency small needs—“don’t miss blocking dangerous operations” and “don’t miss waiting events”—into a plugin, with one-time installation, enabled by default, and adjustable in a single settings card. If your daily DSH use is also troubled by these two things, you can give it a try.

  • GitHub: https://github.com/Pidreamleaves/dsh-pi-kit
  • You can also search for dsh-pi-kit in the DSH community plugin directory to view the listing page.