Skip to content
Back to search

dsh-local-plugins

Keeps edited dsh plugins as local git repos; deploys committed snapshots via atomic symlink swap.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/ishanshmalviya5--dsh-local-plugins/badge.svg)](/listings/ishanshmalviya5--dsh-local-plugins)

HTML

<a href="/listings/ishanshmalviya5--dsh-local-plugins"><img src="/api/listings/ishanshmalviya5--dsh-local-plugins/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

1. In a terminal (replace `web` with your profile name if you use another):

   dsh plugin --profile web add github:ishanshmalviya5/dsh-local-plugins

2. Restart dsh web. 3. Open **Settings → Local Plugins**.

You need `git`, `npm` and Node 26 or newer, on macOS or Linux ([details](#compatibility)).

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 136 lines
  1. # dsh-local-plugins
  2. [![CI](https://github.com/ishanshmalviya5/dsh-local-plugins/actions/workflows/ci.yml/badge.svg)](https://github.com/ishanshmalviya5/dsh-local-plugins/actions/workflows/ci.yml)
  3. **Customize any dsh plugin — even a built-in one — without losing your changes when things update, break or get reinstalled.**
  4. ![Settings → Local Plugins: every plugin you customize, its status in plain words, and the next action you probably want](docs/images/overview.png)
  5. ## What you can do with it
  6. | You want to… | You click | You get |
  7. |---|---|---|
  8. | **Fix or tweak a plugin and keep the fix** | **+ Add → Migrate**, edit, **Commit**, **Apply** | Your change runs in dsh and survives updates and reinstalls |
  9. | **Take the author's new release without losing your tweaks** | **Update** | The new version *plus* your changes; if both touched the same lines you are asked, and nothing breaks meanwhile |
  10. | **Go back** when a change misbehaves | **Deploy older commit…** | The earlier version, instantly |
  11. | **Customize a built-in dsh feature** (for example a model provider) | the same steps, on a built-in plugin | Your version runs; **Unlink** gives the original back |
  12. | **Let an AI agent change a plugin safely** | **Work on it** | An agent opens inside that plugin's folder with the context filled in; it can't switch anything on — only you can |
  13. | **Keep your history tidy so updates stay easy** | **Squash my changes** | An agent collapses all your commits into one on top of the original release; a backup branch is made first and it checks the code is unchanged |
  14. | **Pin a dependency to a newer version** | **Dependency overrides → Apply override** | The override is saved, deployed and checked: you see a ✔ only when it is really installed |
  15. | **Recover after dsh was upgraded or reinstalled** | **Reapply all** | Your customizations are switched back on |
  16. | **Try one exact version** | **+ Add**, `name@1.2.3` (or `…#v1.2.0`) | That version, and it stays put |
  17. | **See what you changed versus the original** | look at the card | "3 files changed vs original", and what is running right now |
  18. | **Stop customizing a plugin** | **Unlink**, then **Delete…** if you like | The original is back; your work is kept in a trash folder you can restore |
  19. | **Keep your work somewhere else too** | it is an ordinary git folder: `~/.dsh/local-plugins/<plugin>` | add your own git remote and push |
  20. And when something goes wrong, it tells you whether your setup is still safe and what to do next — it does not just say "failed".
  21. ![A failed Apply: nothing was switched on, and the panel says what to do next](docs/images/failure.png)
  22. ## Install (2 minutes)
  23. 1. In a terminal (replace `web` with your profile name if you use another):
  24. ```bash
  25. dsh plugin --profile web add github:ishanshmalviya5/dsh-local-plugins
  26. ```
  27. 2. Restart dsh web.
  28. 3. Open **Settings → Local Plugins**.
  29. You need `git`, `npm` and Node 26 or newer, on macOS or Linux ([details](#compatibility)).
  30. ## Your first customization
  31. 1. **+ Add → Migrate** and pick a plugin you already use. Anything you had already changed by hand is kept as your starting point.
  32. 2. Make your change — edit the files in `~/.dsh/local-plugins/<plugin>`, or press **Work on it** to have an AI agent do it with you.
  33. 3. **Commit**, then **Apply**, then restart dsh web.
  34. That's the whole loop. Nothing changes in dsh until you click **Apply**, and if the new version can't be built or doesn't pass the checks, the old one simply keeps running.
  35. ## More stories
  36. <details><summary><b>The author released a new version</b></summary>
  37. Press **Check now** (it also checks shortly after dsh starts). A plugin with news shows **Update available**; click **Update**. Your changes and the new release are combined for you. If you and the author changed the same lines, the card lists those files and you choose: fix them (or press **Fix with agent**) and **Finish update**, or **Abort** to forget the attempt. Your running plugin is untouched throughout; you decide when to **Apply**.
  38. ![A conflicting update: which files, and three safe choices](docs/images/conflict.png)
  39. </details>
  40. <details><summary><b>A change made things worse</b></summary>
  41. Click **Deploy older commit…** and pick the version that worked. If dsh itself starts misbehaving right after you applied something, it notices, puts the last working version back, and shows a message — your edits are saved for you to fix with **Work on it**.
  42. If dsh won't start at all, run this in a terminal to put every original plugin back: `node ~/.dsh/local-plugins/.deployed/dsh-local-plugins/scripts/undo.mjs --all`
  43. </details>
  44. <details><summary><b>I'm customizing a built-in plugin and want out</b></summary>
  45. **Unlink (restore original)** gives dsh the original, untouched plugin again. Your version stays listed (as **Not applied**), so you can switch it back on with **Apply** whenever you like.
  46. </details>
  47. <details><summary><b>I want to remove a plugin from the list</b></summary>
  48. **Unlink** it first, then **Delete…** and type its name. Your work is moved to `~/.dsh/local-plugins/.trash/`, not erased. Move the folder back and press **Repair installation** to bring it back.
  49. </details>
  50. <details><summary><b>I don't know what state things are in</b></summary>
  51. Press **Repair installation**. It looks for anything that doesn't add up (for example after a crash or a dsh upgrade), fixes what is safe, tells you about the rest, and never deletes your work. **Recent operations** shows what ran, how long it took, and the log; **Disk usage** shows space per plugin and lets you clean up old versions with a preview first.
  52. ![Recent operations and disk usage](docs/images/history-disk.png)
  53. </details>
  54. <details><summary><b>Using an exact version</b></summary>
  55. For npm plugins: `name`, `name@1.2.3` or `name@beta`. For plugins from git: a web address, `github:owner/repo` or `git@host:owner/repo`, optionally ending in `#v1.2.0` (a release), `#branch`, or `#commit`. A pinned release or commit never moves by itself.
  56. </details>
  57. ## What the labels mean
  58. | Label | Meaning | Do this |
  59. |---|---|---|
  60. | **Applied** | dsh is running your latest version | nothing |
  61. | **Changes pending** | you have newer or uncommitted work that isn't running | **Commit**, then **Apply** |
  62. | **Update available** | the author has a newer version | **Update** |
  63. | **Conflict** | an update needs your decision about some files | **Finish update** or **Abort** |
  64. | **Link lost** / **Reapply required** | dsh was upgraded or reinstalled | **Reapply all** (safe to repeat) |
  65. | **Broken** | the records and the files disagree | **Repair installation** |
  66. | **Disabled** | it crashed dsh and was taken out so dsh could start | **Work on it**, fix, **Commit**, **Apply** |
  67. | **Not applied** | you track it, but dsh uses the normal plugin | **Apply** when you want yours |
  68. ## You stay in control
  69. * **Scripts need your OK.** Some plugins want to run install or build scripts with your full access. That is off by default; you choose *Allow this time* or *Always allow for this plugin*, and it asks again if the publisher changes.
  70. ![A plugin asking for permission: nothing has gone live yet](docs/images/permission.png)
  71. * **Your work is never silently lost.** Unlink, Delete, rollbacks and crash recovery all keep your edits somewhere you can get them back.
  72. * **Only a finished, checked version is ever switched on** — never a half-done edit.
  73. * **It only talks to the sources you track** (the plugin's git or npm origin).
  74. How this is guaranteed: [Security](docs/security.md) · [Recovery](docs/recovery.md) · [How it works](docs/architecture.md).
  75. ## Compatibility — dsh-local-plugins 0.3.0
  76. | Where | Status |
  77. |---|---|
  78. | macOS (Apple silicon), Node 26 | ✅ **Supported.** Tested by hand end to end against a real dsh, and in CI |
  79. | Linux (Ubuntu), Node 26 | 🟡 Lint, all unit tests and package checks pass in CI. Not yet tried end to end against a real dsh |
  80. | Linux, Node 22 / 24 | 🟡 Same CI results, but outside the supported range (needs Node 26 or newer) |
  81. | Windows | ❌ Not supported — it says so and doesn't start |
  82. Built and tested against **dsh 0.2.0-rc.2**. Upgrading from version 0.1 needs nothing from you: your plugins stay exactly as they are (details in the [CHANGELOG](CHANGELOG.md)).
  83. ## Good to know
  84. * If a plugin crashes dsh *before* this one loads, it can't repair that itself — use the `undo.mjs` command above.
  85. * The check before going live confirms the files are complete and readable; it does not run the plugin first.
  86. * Built-in plugins follow the version that ships with your dsh, not newer npm releases.
  87. * It does one thing at a time; if you click while it is busy, it asks you to wait.
  88. ## For developers
  89. [HTTP API](docs/api.md) · [Status rules](docs/state-machine.md) · [Troubleshooting](docs/troubleshooting.md) · [Performance](docs/performance.md) · [Release checklist](docs/release-checklist.md) · [Developing](docs/development.md)
  90. Contributions are welcome, including AI-assisted ones: read [CONTRIBUTING.md](CONTRIBUTING.md) first (and [AGENTS.md](AGENTS.md) for coding agents).
  91. ## License
  92. MIT — see [LICENSE](LICENSE).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.