@Wlaeg/dsh-pet-desktop-linux avatar

@Wlaeg/dsh-pet-desktop-linux

A transparent always-on-top desktop pet for DSH on Linux (X11 / XWayland)

PluginDesktopNotifications
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

Transparent, always-on-top GTK3 desktop pet for DSH on Linux X11/XWayland that animates to show each session's state.

  • Floating transparent GTK3 window with no background or border, stays always on top
  • Pet animation reflects DSH session state: idle, working, waiting, failed, finished
  • Window keeps its input region, so clicks on the pet reach the pet
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 github:Wlaeg/dsh-pet-desktop-linux#v1.0.0
verified v1.0.0

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.2
v1.0.0✓·
Install compatibility (by plugin version, dsh versions within)
Legend:✓ L5 runtime verified○ ecosystem plugin◼ ecosystem app✗ failed
v1.0.0github✓ 1 runtime-verified2026-10-21

https://github.com/Wlaeg/dsh-pet-desktop-linux

✓dsh 0.2.1-rc.2current2026-10-21L5 · runtime verified
Environment & artifact
  • • Node.js: v24.14.0
  • • DSH: 0.2.1-rc.2
  • • Plugin artifact: github · https://github.com/Wlaeg/dsh-pet-desktop-linux#v1.0.0
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-pet-desktop-linux@v1.0.0@dsh0.2.1-rc.2 · profile: l4-sandbox

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

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-21
spec github:Wlaeg/dsh-pet-desktop-linux#v1.0.0 · channel GitHub source · outcome ran · exit 0
check took: 5.8s
Install succeeded✓ Passed
Source: Windows ACL sandbox · Method: sandbox install run · Captured 2026-10-21
spec github:Wlaeg/dsh-pet-desktop-linux#v1.0.0 · channel GitHub source · outcome ran · exit 0
check took: 5.8s
Installed artifact confirmed✓ Passed
Source: Windows ACL sandbox · Method: sandbox install run · Captured 2026-10-21
spec github:Wlaeg/dsh-pet-desktop-linux#v1.0.0 · channel GitHub source · outcome ran · exit 0
check took: 5.8s
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-21
spec github:Wlaeg/dsh-pet-desktop-linux#v1.0.0 · install mode reused L4 scratch
check took: 115ms
Web boot ready✓ Passed
Source: DSH runtime · Method: web boot · Captured 2026-10-21
ready line dsh web: http://127.0.0.1:64016/?token=…
HTTP endpoint served✓ Passed
Source: DSH runtime · Method: HTTP request · Captured 2026-10-21
path / · HTTP 200 · took 115ms
Plugin active in inventory✓ Passed
Source: DSH runtime · Method: plugin inventory query · Captured 2026-10-21
verdict active · entries 150
match: include:dsh-pet-desktop-linux · dsh-pet-desktop-linux · 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.

Only the latest 3 published versions are shown; source-snapshot (commit hash) groups, unstated groups and older versions are omitted — the full archive stays in the data layer (snapshot/unstated groups appear only when a plugin has no published version).

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

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-pet-desktop-linuxAutomated 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 versionv1.0.0dsh manifest
scanned versionv1.0.0git2026-10-21
current versionv1.0.0same version
vet verdictclean · git

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

show static findings (6)
  • warningnetIp · networkdesktop/pet.py:980

    with urllib.request.urlopen(f"http://127.0.0.1:{port}/", timeout=timeout):

  • warningnetIp · networkdesktop/pet.py:1579

    Gio.AppInfo.launch_default_for_uri(f"http://127.0.0.1:{self.port}/", None)

  • warningchildProcess · code-execlib/index.js:678

    spawned = spawn(python, args, {

  • warningshellExec · shelllib/index.js:348

    execFile(python, ['-c', code], { timeout, windowsHide: true }, (error, stdout, stderr) => {

  • warningshellExec · shelllib/index.js:382

    detail = `${execFileSync(python, ['--version'], { encoding: 'utf8' }).trim()} · ${python}`

  • warningfsWrite · fileslib/index.js:169

    fs.writeFileSync(tmp, `${JSON.stringify(config, null, 2)}\n`, { mode: 0o600 })

2model reads redacted source context · never executes plugin code
highest grademedium
merged intooverall medium
audited at2026-10-19
findings0 critical·0 high1 medium / 1 low hidden
show 2 audit findings
  • mediumPrivate-LAN-reachable API lets any host start/stop the pet and rewrite its configlib/index.js:43

    allowed() explicitly accepts 10/8, 127/8, 192.168/16, 172.16/12, fc00::/7 and fe80::/10 peers, and trustedWrite() only requires the caller to send the publicly visible header x-dsh-pet-desktop: 1 plus an application/json content-type — values any non-browser client can set. Because the code itself notes DSH's webServer often binds 0.0.0.0, any host on the same LAN can POST /api/start, /api/stop and /api/config to spawn or kill a GUI process on the user's desktop and change selected pet/size/hidden/autostart, and GET /api/state, /api/config and /api/deps to read local paths, the pet inventory a

  • lowUnauthenticated /api/deps?refresh=1 forces repeated python subprocess spawnslib/index.js

    Any peer that passes allowed() can bypass the 30 s probe cache and make the host run up to four python3 processes per request (python --version via execFileSync plus up to three import probes with an 8 s timeout), with no rate limiting — a cheap resource-exhaustion lever against the DSH host process.

Pet desktop controller is well-contained (fixed argv, no shell, sanitized config); the only real gap is a private-LAN-reachable control API guarded by a public constant header.

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-10-13

• Stars: ★ 1 · Forks: 0

• Health: Active — committed within last 30 days

Source

GitHub: github.com/Wlaeg/dsh-pet-desktop-linux

Was this page helpful?