Install verification: runtime verified (L5) · tested on dsh 0.2.1-rc.2 · last checked Install verification details →
What it doesAI
Guard plugin that blocks shell commands killing processes by image name, wildcard, process group, or unfiltered enumeration.
- Refuses kill commands targeting processes by image name
- Blocks wildcard, process-group, and unfiltered process kills
- Prevents accidental termination of the DSH GUI window
Capability tags are AI-inferred or rule-extracted from the README (see badge) — vocabulary-limited, not install-verified. AI = inferred; README = literal keyword from the readme.
Installation
dsh plugin --profile web add dsh-process-guardInstall method: npm · runtime verified (L5)
Verification & Compatibility
Grouped by plugin version: each card lists the dsh versions actually tested against that artifact version and their install verdicts (L5 wins). Untested combinations are omitted — absence means untested, never assumed compatible. L1–L3 are a plugin-level static archive (independent of the dsh version — the same verdict on every dsh row): they sit in each row's level grid next to L4/L5, marked "static", while their evidence is stored once per plugin inside that row's "checks & evidence" instead of being duplicated per version.
External credentials (plugin-level): none detected
○ The author declares no dsh version requirement — install is not blocked by version.
| plugin ＼ dsh | dsh 0.2.1-rc.2 current | dsh 0.2.1-alpha.4 | dsh 0.2.1-alpha.2 |
|---|---|---|---|
| 0.2.1 | ✓ | ✓ | ✗ |
| v0.2.1 | · | · | · |
0.2.1npm✓ 2 runtime-verified1 failed2026-10-20
dsh-process-guard
✓dsh 0.2.1-rc.2current2026-10-20L5 · runtime verified
- • Node.js: v24.14.0
- • DSH: 0.2.1-rc.2
- • Plugin artifact: npm · dsh-process-guard@0.2.1
ID: dsh-process-guard@0.2.1@dsh0.2.1-rc.2 · profile: l4-sandbox
Issued: 2026-10-20 · expires: 2026-10-27
View checks & evidence
active in loader tree (150 entries)
L1–L3 are plugin-level static conclusions (baseline, identical across dsh versions): evidence is stored once per plugin.
✓dsh 0.2.1-alpha.42026-10-18L5 · runtime verified
- • Node.js: v24.14.0
- • DSH: 0.2.1-alpha.4
- • Plugin artifact: npm · dsh-process-guard@0.2.1
ID: dsh-process-guard@0.2.1@dsh0.2.1-alpha.4 · profile: l4-sandbox
Issued: 2026-10-18 · expires: 2026-10-25
View checks & evidence
active in loader tree (150 entries)
L1–L3 are plugin-level static conclusions (baseline, identical across dsh versions): evidence is stored once per plugin.
✗dsh 0.2.1-alpha.22026-10-15L5 · failed
- • Node.js: v24.14.0
- • DSH: 0.2.1-alpha.2
- • Plugin artifact: npm · dsh-process-guard@0.2.1
ID: dsh-process-guard@0.2.1@dsh0.2.1-alpha.2 · profile: l3-fullscan
Issued: 2026-10-15 · expires: 2026-10-22
View checks & evidence
L1–L3 are plugin-level static conclusions (baseline, identical across dsh versions): evidence is stored once per plugin.
v0.2.1github2026-10-14
https://github.com/CetOeil/dsh-process-guard
No runtime install test for this version (static scan only) — compatibility unknown, never assumed.
Author badges
Embed the official badges in your README to showcase security & install-test status:
`[](https://www.dsh.so/artifact/dsh-process-guard/)``[](https://www.dsh.so/artifact/dsh-process-guard/)`Security Report
Two automated layers, neither a manual review: a static scan (per-plugin rule checks) and a model-driven dynamic security audit that covers only the subset static-flagged at warn or above and never executes plugin code.
Static low, dynamic low — stricter wins → overall low.
v0.2.1dsh manifest0.2.1npm2026-10-210.2.1same versionclean · npmVet is an AST static scan (npm artifact or git source).
show static findings (2)
- criticalshellExec · shell
lib/matcher.js:374if (/^find(?:\.exe)?\b/i.test(tail) && /-exec(?:dir)?$/i.test(tail)) return true; - warningnetIp · network
lib/matcher.js:884return `process-guard: blocked - this terminates ${images} after selecting it by image name. That image may host the DSH GUI (http://127.0.0
show 1 audit findings
- lowGuard's interpreter/wrapper denylist is incomplete, so some name-based kills pass uninspected
lib/matcher.js:76Indirect execution is only searched for executors and interpreters named in the enumerated lists (EXEC_WRAPPERS, INLINE_CODE_EXECUTABLES, INTERPRETER_EXECUTABLES). A payload inside an unlisted interpreter, e.g. `awk 'BEGIN{system("killall chrome")}'`, is hidden by the single-quote masking in maskViews() and matches no executor pattern, so evaluateCommand() returns allow and the protected image (browser / node harness host) can still be killed. This is a defense-in-depth gap in the plugin's own stated purpose, not a new capability for the attacker: it requires the caller to deliberately choose
No exploitable risk: this is a pure-text defensive guard with no network, filesystem or code-execution path; the static-scan hits are attack-signature strings used for detection.
Rule: the dynamic audit can only raise risk, never lower it (raise-only, never an exemption); a wrong raise is withdrawn by human review and the tier falls back to the static verdict. Overall verdict = the stricter of the two layers.
Disclaimer: the static scan and the dynamic security audit are both automated analysis, not a security guarantee. Always review what you install.
Activity
Last commit 2026-09-25 · activity: Active
• Repo created: 2026-09-21
• Stars: ★ 1 · Forks: 0
• Health: Active — committed within last 30 days
Source
Author README
View on GitHub ↗The author's original README from the repository — fetched live, unedited (the English page loads the default README).