@aa2246740/dsh-notch avatar

@aa2246740/dsh-notch

Native macOS Notch for DSH sessions, inline answers and animated task status

PluginDesktopAutomationNotifications
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

Native macOS notch app that shows DSH session status, unanswered questions and unread results, with inline answers and click-to-focus.

  • Displays real session state and unread results at the screen edge
  • Answer agent questions inline without leaving the notch
  • Click to jump back to the matching DSH session; idle standby robot
desktopAInotificationAI

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-notch
verified 0.3.6

Install 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

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.3.6✓✓✗
v0.3.4···
Install compatibility (by plugin version, dsh versions within)
Legend:✓ L5 runtime verified○ ecosystem plugin◼ ecosystem app✗ failed
0.3.6npm✓ 2 runtime-verified1 failed2026-10-19

dsh-notch

✓dsh 0.2.1-rc.2current2026-10-19L5 · runtime verified
Environment & artifact
  • • Node.js: v24.14.0
  • • DSH: 0.2.1-rc.2
  • • Plugin artifact: npm · dsh-notch@0.3.6
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-notch@0.3.6@dsh0.2.1-rc.2 · profile: l4-sandbox

Issued: 2026-10-19 · expires: 2026-10-26

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-19
spec dsh-notch · channel npm package · outcome ran · exit 0
check took: 3.2s
Install succeeded✓ Passed
Source: Windows ACL sandbox · Method: sandbox install run · Captured 2026-10-19
spec dsh-notch · channel npm package · outcome ran · exit 0
check took: 3.2s
Installed artifact confirmed✓ Passed
Source: Windows ACL sandbox · Method: sandbox install run · Captured 2026-10-19
spec dsh-notch · channel npm package · outcome ran · exit 0
check took: 3.2s
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-19
spec dsh-notch · install mode reused L4 scratch
check took: 317ms
Web boot ready✓ Passed
Source: DSH runtime · Method: web boot · Captured 2026-10-19
ready line dsh web: http://127.0.0.1:52577/?token=…
HTTP endpoint served✓ Passed
Source: DSH runtime · Method: HTTP request · Captured 2026-10-19
path / · HTTP 200 · took 317ms
Plugin active in inventory✓ Passed
Source: DSH runtime · Method: plugin inventory query · Captured 2026-10-19
verdict active · entries 150
match: include:dsh-notch · dsh-notch · 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-16L5 · runtime verified
Environment & artifact
  • • Node.js: v24.14.0
  • • DSH: 0.2.1-alpha.4
  • • Plugin artifact: npm · dsh-notch@0.3.6
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-notch@0.3.6@dsh0.2.1-alpha.4 · profile: l4-sandbox

Issued: 2026-10-16 · expires: 2026-10-23

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-16
spec dsh-notch · channel npm package · outcome ran · exit 0
check took: 2.6s
Install succeeded✓ Passed
Source: Windows ACL sandbox · Method: sandbox install run · Captured 2026-10-16
spec dsh-notch · channel npm package · outcome ran · exit 0
check took: 2.6s
Installed artifact confirmed✓ Passed
Source: Windows ACL sandbox · Method: sandbox install run · Captured 2026-10-16
spec dsh-notch · channel npm package · outcome ran · exit 0
check took: 2.6s
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-16
spec dsh-notch · install mode reused L4 scratch
check took: 228ms
Web boot ready✓ Passed
Source: DSH runtime · Method: web boot · Captured 2026-10-16
ready line dsh web: http://127.0.0.1:62661/?token=…
HTTP endpoint served✓ Passed
Source: DSH runtime · Method: HTTP request · Captured 2026-10-16
path / · HTTP 200 · took 228ms
Plugin active in inventory✓ Passed
Source: DSH runtime · Method: plugin inventory query · Captured 2026-10-16
verdict active · entries 150
match: include:dsh-notch · dsh-notch · 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.22026-10-15L5 · failed
Environment & artifact
  • • Node.js: v24.14.0
  • • DSH: 0.2.1-alpha.2
  • • Plugin artifact: npm · dsh-notch@0.3.6
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
Failed
Sandbox install failed
L5 · failed

ID: dsh-notch@0.3.6@dsh0.2.1-alpha.2 · profile: l3-fullscan

Issued: 2026-10-15 · expires: 2026-10-22

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-notch · channel npm package · outcome ran · exit 0
check took: 9.8s
Install succeeded✓ Passed
Source: Windows ACL sandbox · Method: sandbox install run · Captured 2026-10-14
spec dsh-notch · channel npm package · outcome ran · exit 0
check took: 9.8s
Installed artifact confirmed✓ Passed
Source: Windows ACL sandbox · Method: sandbox install run · Captured 2026-10-14
spec dsh-notch · channel npm package · outcome ran · exit 0
check took: 9.8s
L5 · Run tested✕ Failed
Sandbox install passed✓ Passed
Source: Windows ACL sandbox · Method: sandbox install run · Captured 2026-10-14
spec dsh-notch · install mode reused L4 scratch
check took: 0ms
Web boot ready✕ Failed
boot failed
HTTP endpoint served✕ Failed

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

v0.3.4github2026-10-14

https://github.com/aa2246740/dsh-notch

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

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-notchAutomated review · daily

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

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

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

show static findings (9)
  • warningshellExec · shelldesktop/notch-lifecycle.mjs:9

    const text = execFileSync('/bin/ps', ['-p', String(pid), '-o', 'lstart=', '-o', 'comm='],

  • warningchildProcess · code-execdesktop/restart-probe.mjs:17

    const child = spawn('/bin/sleep', ['60']); await once(child, 'spawn'); return child

  • warningchildProcess · code-execdesktop/restart-probe.mjs:32

    const child = spawn(file, args, { ...options, env: { ...process.env, DSH_NOTCH_RUNTIME_FILE: runtime } })

  • warningnetIp · networkdesktop/restart-probe.mjs:30

    writtenAt: Date.now(), origin: 'http://127.0.0.1:9', token: 'offline-test' }))

  • warningshellExec · shelllib/index.mjs:12

    const text = execFileSync("/bin/ps", [

  • warningnetIp · networklib/index.mjs:691

    return new URL(req.url ?? "/", "http://127.0.0.1").searchParams.get("token") === token;

  • warningnetIp · networklib/index.mjs:757

    const path = new URL(req.url ?? "/", "http://127.0.0.1").pathname;

  • warningnetIp · networksrc/http.ts:18

    const url = new URL(req.url ?? '/', 'http://127.0.0.1')

  • warningnetIp · networksrc/http.ts:97

    const url = new URL(req.url ?? '/', 'http://127.0.0.1')

2model reads redacted source context · never executes plugin code
highest gradelow
merged intooverall low
audited at2026-10-17
findings0 critical·0 high0 medium / 2 low hidden
show 2 audit findings
  • lowAPI token is also accepted from a URL query stringsrc/http.ts:19

    The bearer secret that authorizes /approve, /answer and /focus can be carried in a URL, where it may be captured by access logs, proxy logs, shell history or Referer headers. Same code ships in lib/index.mjs.

  • lowUnauthenticated loopback endpoints disclose focus wishes and accept sidebar writessrc/http.ts:104

    /pending-focus and /sidebar skip the Bearer check and rely only on loopback + Origin/Host heuristics. Any same-user local process (or a remote page reaching the listener through a loopback-terminating tunnel) can read pending focus session ids and inject fabricated rows/unread badges into the Notch UI. Real-world abuse is limited: cross-origin browser pages are blocked by the required application/json content-type (preflight) and the sec-fetch-site check, and same-user code can already read the 0600 token file.

No critical/high/medium issue: helper spawn uses a user-configured path without a shell, ps gets a validated integer, the token stays in a 0600 file; only low-risk loopback auth gaps remain.

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

• Repo created: 2026-09-10

• Stars: ★ 8 · Forks: 4

• Health: Active — committed within last 30 days

Source

GitHub: github.com/aa2246740/dsh-notch

Was this page helpful?