Introduction

In DeepSeek Harness (DSH)’s plugin workflow, developers often need to determine which agent preset the current local agent activity is closer to. dsh-agent-preset-recommender addresses this problem by aggregating observable session, project, and workflow metadata from Codex, Claude Code, CodeBuddy, and WorkBuddy, and providing minimal / standard preset recommendations, along with optional capability recommendations, based on local deterministic rules.

What is it

LeemanCheung/dsh-agent-preset-recommender is a privacy-preserving local activity scanner and agent preset recommendation plugin for DSH, maintained by LeemanCheung, licensed under MIT, and requires Node.js >=20.

It solves the problem of generating bounded, reviewable reports from the usage traces of local agent tools without making LLM calls, executing commands, changing presets, or initiating network requests.

Core Features

The core capabilities of the plugin are focused on scanning, aggregating, recommending, and reporting.

  • Bounded scanning of session, project, and workflow metadata from Codex, Claude Code, CodeBuddy, and WorkBuddy; skipping caches, builds, .git, symlinks, inaccessible roots, and unknown content.
  • Aggregating tools, sessions, workflows, and daily activities based on the installed local HMAC Project ID.
  • Not persisting prompts, replies, commands, arguments, raw events, paths, usernames, secrets, or file bodies.
  • Recommending minimal / standard presets, as well as optional capabilities like delegation, workflow, web, MCP, and LSP, based on deterministic rules.
  • Providing two agent tools: scan_agent_projects and get_agent_preset_recommendations.
  • Atomically persisting private reports and supporting ad-hoc scans and scheduled scans.

It is important to note its boundaries: it is advisory only, does not make LLM calls, does not install content, does not modify presets, does not initiate network requests, does not infer the code presentation variant, and does not judge task quality.

Installation and Usage

The following command is used to install this plugin into a specified DSH profile:

dsh plugin --profile web add github:LeemanCheung/dsh-agent-preset-recommender

After installation is complete, restart the selected DSH profile.

The default report path is:

$DSH_HOME/state/agent-preset-recommender/report.json

If DSH_HOME is not set, it uses:

~/.dsh

Typical Usage

A minimal reproducible workflow is as follows:

  1. Execute the installation command to add the plugin to the target DSH profile.

  2. Restart that DSH profile.

  3. Trigger a scan within the scope where the plugin is available, or wait for ad-hoc scans and scheduled scans to generate reports.

  4. View the private report in the default report path to confirm preset recommendations, optional capability recommendations, and aggregation results.

If you need to access results via agents, you can use the two tools provided by the plugin:

  • scan_agent_projects: Used to perform a new bounded scan.
  • get_agent_preset_recommendations: Used to read the saved report.

Use Cases and Notes

This plugin is suitable for developers or DevOps personnel who need to evaluate local agent activities in DSH, select minimal or standard presets, and are concerned about sensitive data not being written to disk.

Since the plugin runs with the permissions of the current dsh process, you should check the source code and the MIT license before installing.

It is recommended to use it as a local advisory tool rather than an auto-configurator: it will not enable capabilities, execute commands, modify presets, or access the network on behalf of the user. If stronger auditing or more granular evidence is required, manual judgment should be combined with the source code and report files.

References

Community Directory:

https://www.skillhub.cn/plugins/LeemanCheung/dsh-agent-preset-recommender

GitHub:

https://github.com/LeemanCheung/dsh-agent-preset-recommender