etbystudio/dsh-commands

Registers one slash command per Markdown file under <dshHome>/commands, with a watcher that keeps the registry live.

Gives the filesystem the same command surface the skill loader already had, mirroring @deepseek-ai/dsh-skill-filesystem: drop a Markdown file in a directory and it becomes a slash command in every DSH UI that reads the command registry, because it registers against ctx.commands rather than a specific front end. A Chokidar watcher anchored on a realpath with depth: 1 and awaitWriteFinish keeps registrations in sync as you add, edit or delete files, and a missing root is probed from the nearest existing ancestor so creating ~/.dsh/commands later still gets picked up; the registry's own commands/change event refreshes live discovery UIs. Conflicts are resolved in favour of code: a file command is low priority, so if a plugin already registered the name the file is skipped with a warning and the programmatic registration wins.

Tools & Capabilities ★ 0
View on GitHub ↗

Install

dsh plugin add @etby-studio/dsh-commands

The npm line, kept without --profile because the README does not assume one. The package declares dsh.bundle.patch, so dsh plugin add installs it as a profile layer that inserts its own plugin row — do not also add the row to $DSH_HOME/profiles/<name>/cordis.patch.yml, because a second insert of the same id fails the load. After boot, any *.md file under <dshHome>/commands is a command: the filename stem is the name, frontmatter supplies the description and the body is the instruction executed.

Compatibility

Targets dsh 0.2.0-rc.2 with peer range ^0.2.0-rc.2, and the README states the rule behind that pin: dsh plugin add refuses packages without dsh.bundle, and DSH loads a bundle only when every @deepseek-ai/dsh-* peer range matches the runtime version — so a mismatched harness means the layer is skipped, not half-loaded. dshHome defaults to $DSH_HOME or ~/.dsh; commandDirs adds extra roots scanned after <dshHome>/commands. Invalid files — missing frontmatter, empty description, invalid name, empty body — are skipped with a warning and never registered.

Details

Alternatives

stuarthu/dsh-chrome · welsione/dsh-mmx-bridge · TYEclipse/dsh-geodesy

More plugins in Tools & Capabilities

Browse more in Tools & Capabilities

Guides for Tools & Capabilities plugins