dsh-plugin-hello

dsh-plugin-hello is the smallest complete bundle example in the DeepSeek Harness community plugin ecosystem. It registers a single model-callable tool named hello that accepts a required name string and returns a greeting such as Hello, Ada!. The problem it addresses is clear: it gives first-time source-code readers and prospective contributors an extremely small yet fully working reference that walks through the entire dsh-plugin lifecycle, from profile loading and tool registration to configuration overrides and the src-to-lib build step, in a form they can fork and modify directly.

On the capability side, the plugin registers the hello tool via the ctx.tools context object, allows overriding the default greeting prefix (always Hello) through a single row in the profile cordis.patch.yml, and fails fast at load time when the configuration is invalid, preventing silent runtime degradation. It carries zero external dependencies, its build path from src to lib is transparent, and it doubles as the minimal test target when debugging the dsh plugin loading pipeline.

The intended audience is equally specific: newcomers picking up DeepSeek Harness plugin development, contributors who want to internalize how the ctx context object and bundle declaration work under the hood, and tech leads who need a minimal working skeleton before committing to a production-grade plugin.