registry / Install hook abuse / termdock / 1.4.258

termdock@1.4.258

A complete web-based terminal application with modern UI

AI Security Review

scanned 1mo ago · by lpm-firewall-ai

The package contains no inspected evidence of data theft, remote payload delivery, or a lifecycle self-dependency chain. However, automatic installation of a system package, including sudo attempts, is a concrete risky install hook and should be warned.

Static reason

High-risk behavior combination matched malicious policy.; source matched previously finalized malicious package; routed for review

Trigger

npm installation or CLI startup without tmux installed.

Impact

It can modify the host system and prompt for elevated privileges without an explicit setup command.

Mechanism

Automatic shell execution of privileged system package-manager commands.

AI rationale

Evidence

package.jsonscripts/postinstall.mjsdist/server/utils/bootCheck.js

Decision evidence

public snapshot

AI called this Suspicious at 90.0% confidence as Dangerous Capability with low false-positive risk.

Evidence for warning

The npm postinstall hook runs automatically during installation.
Postinstall tries to install tmux through system package managers, including sudo on Linux.
CLI startup repeats the automatic tmux installation attempt when tmux is absent.

Evidence against

No self-dependency is declared.
Agent hook writes are exposed through explicit local API install routes and only refresh previously installed stale entries.
No credential harvesting or unrelated network exfiltration was found in the inspected files.

Behavioral surface

Source

ChildProcessCryptoEnvironmentVarsEvalFilesystemNetworkShellWebSocket

Supply chain

HighEntropyStringsMinifiedPossibleObfuscationTelemetryUrlStrings

ManifestNo manifest risk signals triggered.

Source & flagged code

31 flagged

package.jsonView file

Lines 24-64json

24 "dev:client": "vite",

25 "dev:server": "cross-env PORT=9835 tsx watch src/server/entry.ts",

26 "build": "npm run clean && npm run build:client && npm run build:server && npm run build:runtime-manifest",

27 "build:desktop": "node scripts/prepare-desktop-tokens.mjs && tsc -p tsconfig.desktop.json && esbuild desktop/preload.cts --bundle --platform=node --format=cjs --external:electron --outfile=.desktop-dist/preload.cjs && esbuild desktop/renderer/services.tsx --bundle --platform=browser --format=iife --minify --outfile=desktop/renderer/services.js",

28 "desktop:dev": "npm run build && npm run build:desktop && electron-forge start",

29 "desktop:prepare": "npm run build && npm run build:desktop && node scripts/prepare-desktop-runtime.mjs",

30 "desktop:make": "node scripts/ensure-macos-appdmg.mjs && npm run desktop:prepare && electron-forge make",

31 "build:client": "vite build && node scripts/precompress-client.mjs",

32 "build:server": "tsc -p tsconfig.server.json && node -e \"require('fs').chmodSync('dist/server/cli.js', 0o755)\"",

33 "build:runtime-manifest": "node scripts/generate-runtime-manifest.mjs",

34 "generate:pwa-assets": "pwa-assets-generator --config pwa-assets.config.ts",

35 "preview": "vite preview",

36 "start": "node dist/server/cli.js",

37 "lint": "tsc --noEmit",

38 "trace:diff": "node scripts/inspect-diff-trace.mjs",

39 "trace:fsio": "node scripts/inspect-fs-io.mjs",

40 "release:classify": "node scripts/classify-release.mjs",

41 "test": "vitest --passWithNoTests",

42 "test:ui": "vitest --ui",

43 "prepublishOnly": "npm run build",

44 "postinstall": "node scripts/postinstall.mjs"

High

Install Time Lifecycle Scripts

Package defines install-time lifecycle scripts.

package.jsonView on unpkg · L44

Medium

Ambiguous Install Lifecycle Script

Install-time lifecycle script is not statically allowlisted and needs review.

package.jsonView on unpkg · L44

45 },

46 "dependencies": {

47 "@chainsafe/libp2p-noise": "17.0.0",

48 "@dnd-kit/core": "^6.3.1",

49 "@dnd-kit/sortable": "^10.0.0",

50 "@dnd-kit/utilities": "^3.2.2",

51 "@hello-pangea/dnd": "^18.0.1",

52 "@libp2p/crypto": "5.1.9",

53 "@libp2p/interface": "3.1.0",

54 "@libp2p/peer-id": "6.0.0",

55 "@libp2p/utils": "7.0.7",

56 "@noble/hashes": "2.4.0",

57 "@serenity-kit/opaque": "1.1.0",

58 "@types/cookie-parser": "^1.4.10",

59 "@types/csurf": "^1.11.5",

60 "@types/refractor": "^2.8.0",

61 "@use-gesture/react": "^10.3.1",

62 "@xterm/addon-clipboard": "^0.3.0-beta.287",

63 "@xterm/addon-fit": "^0.12.0-beta.287",

64 "@xterm/addon-image": "^0.10.0-beta.287",

dist/server/utils/kicadBoardInspection.jsView file

Lines 1-21javascript

1import { execFile } from 'child_process';

2const KICAD_INSPECTION_SCRIPT = String.raw `

High

Child Process

Package source references child process execution.

dist/server/utils/kicadBoardInspection.jsView on unpkg · L1

3import json, math, sys

4import pcbnew

dist/server/utils/bootCheck.jsView file

Lines 31-71javascript

31 }

32 catch { /* not in PATH */ }

33 // macOS non-interactive SSH 的 PATH 不包含 Homebrew 路径，手动检查

34 const extraPaths = [

35 '/opt/homebrew/bin',

36 '/usr/local/bin'

dist/client/assets/passwordBootstrap-BvszNW4y.jsView file

Lines 1-3javascript

1import{q as JA,G as oA,r as y,be as EA,b0 as cA,K as z,a6 as hA,cu as DA,t as GA,cy as AA,bZ as G,cm as wA,x as aA,a$

dist/server/routes/terminal.jsView file

Lines 1-36javascript

1import { assertPeerRegistrationAuthority } from '../agent/collaborationPeerTransport.js';

2import { progressRoutes } from '../notifications/progressRoutes.js';

3import { ensureNodePty } from '../utils/ensureNodePty.js';

4import { PtySpawnBackoff, PtySpawnDeferredError } from '../utils/ptySpawnBackoff.js'

dist/server/ptyhost/manager.jsView file

Lines 244-284javascript

244 catch { /* already gone */ }

245 deadline = Date.now() + 1_000;

246 while (alive() && Date.now() < deadline) {

.desktop-dist/main.jsView file

Lines 1-26javascript

1import { readClipboardFiles } from './clipboardFiles.js';

2import { sessionAddress } from './collaborationFederation.js';

3import { prepareServiceFrontend, selectServiceFrontend } from './bundledFrontend.js';

4import { serviceConnection, serviceConnectionKeys, importServiceConnection, saveServiceConnection, invitationForService } from

scripts/postinstall.mjsView file

10L11: import { execSync, spawnSync } from 'child_process'; L12: import { createRequire } from 'module'; ... L31: const r = spawnSync(cmd, [], { shell: true, timeout: timeoutMs, encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] }); L32: return { ok: r.status === 0, stdout: r.stdout, stderr: r.stderr }; L33: } catch { ... L51: const { ensureNodePty } = require_('./ensure-node-pty.cjs'); L52: const PTY_PATH = require_.resolve('node-pty/package.json', { paths: [pkgRoot] }).replace('/package.json', ''); L53: ... L83: const pty = require_(PTY_PATH); L84: const proc = pty.spawn(process.env.SHELL || '/bin/bash', [], { name: 'xterm', cols: 80, rows: 24 }); L85: proc.kill();

High

Sandbox Evasion Gated Capability

Source gates dangerous network, credential, or execution behavior behind CI, host, platform, time, or geo fingerprint checks.

scripts/postinstall.mjsView on unpkg · L10

•matchType = normalized_sha256 matchedPackage = termdock@1.4.249 matchedPath = scripts/postinstall.mjs matchedIdentity = npm:dGVybWRvY2s:1.4.249 similarity = 1.000 summary = normalized source hash matched finalized malicious source

High

Known Malware Source Similarity

Source file is highly similar to a previously finalized malicious package; route for source-aware review.

scripts/postinstall.mjsView on unpkg

dist/server/agent/installers.jsView file

•Manifest-trigger-reachable source links an external AI-agent control path to a behavior-bearing write operation. import fs from 'node:fs'; import os from 'node:os'; import path from 'node:path'; import { execfile, spawn } from 'node:child_process'; import { agentbyslug, ispluginagent } from './registry.js'; import { loadplugins, resolvehooktarget } from './plugins.js'; export const hook_agents = ['claude', 'codex', 'copilot', 'opencode', 'pi', 'grok', 'kimi']; const display_names = { claude: 'claude code', codex: 'codex', copilot: 'copilot cli', opencode: 'opencode', pi: 'pi', grok: 'grok build', kimi: 'kimi code', };

High

Trigger Reachable External Ai Agent Control Surface Mutation

Manifest-trigger-reachable source writes behavior-bearing configuration into a user or project AI-agent control surface.

dist/server/agent/installers.jsView on unpkg

•matchType = normalized_sha256 matchedPackage = termdock@1.4.249 matchedPath = dist/server/agent/installers.js matchedIdentity = npm:dGVybWRvY2s:1.4.249 similarity = 1.000 summary = normalized source hash matched finalized malicious source

High

Known Malware Source Similarity

Source file is highly similar to a previously finalized malicious package; route for source-aware review.

dist/server/agent/installers.jsView on unpkg

dist/client/assets/terminal-C7X98Amf.jsView file

4contains invisible/control Unicode U+200E (left-to-right mark) `)})),this._register(this._bufferService.onResize(()=>this.queueSync())),this._register(this._bufferService.buffers.onBufferActivate(()=>{this._latestYDisp=void 0,this.queueSync()})),this._register(this._bufferService.onScroll(()=>this._syn

Critical

Trojan Source Unicode

Source contains bidi control or invisible Unicode characters associated with Trojan Source attacks.

dist/client/assets/terminal-C7X98Amf.jsView on unpkg · L4

dist/server/cli.jsView file

4Detached bundled service listener: dist/server/cli.js spawns dist/server/entry.js; helper exposes a broad-bound HTTP listener. L4: // 设置（同步 fs 不占线程池，所以放在文件体顶部仍然足够早）。 L5: process.env.UV_THREADPOOL_SIZE ||= '16'; L6: import { config as loadDotenv } from 'dotenv'; ... L10: // dotenv 不会覆盖已存在的环境变量，因此系统环境变量和命令行参数优先级最高 L11: loadDotenv({ path: resolve(os.homedir(), '.termdock', '.env'), quiet: true }); L12: loadDotenv({ path: resolve(process.cwd(), '.env'), quiet: true }); ... L23: import { getMissingCertificateNames } from './utils/certificateNames.js'; L24: import http from 'http'; L25: import https from 'https'; ... L28: import { createHash, randomUUID } from 'crypto'; L29: import { spawn, spawnSync, execFile } from 'child_process'; L30: import { promisify } from 'util';

High

Spawned Bundled Service Listener

Source launches a detached bundled service that exposes a broad-bound HTTP listener.

dist/server/cli.jsView on unpkg · L4

•matchType = normalized_sha256 matchedPackage = termdock@1.4.249 matchedPath = dist/server/cli.js matchedIdentity = npm:dGVybWRvY2s:1.4.249 similarity = 1.000 summary = normalized source hash matched finalized malicious source

High

Known Malware Source Similarity

Source file is highly similar to a previously finalized malicious package; route for source-aware review.

dist/server/cli.jsView on unpkg

scripts/ensure-node-pty.cjsView file

51console.log('Rebuilding node-pty with the Termdock macOS FD cleanup fix...'); L52: const result = spawnSync('npx', ['--yes', 'node-gyp', 'rebuild'], { L53: cwd: ptyRoot, stdio: 'inherit', timeout: 180_000,

High

Runtime Package Install

Package source invokes a package manager install command at runtime.

scripts/ensure-node-pty.cjsView on unpkg · L51

scripts/patch-termdock-font.pyView file

•path = scripts/patch-termdock-font.py kind = build_helper sizeBytes = 4285 magicHex = [redacted]

Medium

Ships Build Helper

Package ships non-JavaScript build or shell helper files.

scripts/patch-termdock-font.pyView on unpkg

dist/client/sw-encrypted-background.js.brView file

•path = dist/client/sw-encrypted-background.js.br kind = high_entropy_blob sizeBytes = 64690 magicHex = [redacted]

High

Ships High Entropy Blob

Package ships high-entropy non-source blobs.

dist/client/sw-encrypted-background.js.brView on unpkg

•path = dist/client/sw-encrypted-background.js.br kind = compressed_blob sizeBytes = 64690 magicHex = [redacted]

Medium

Ships Compressed Blob

Package ships compressed or archive-like blobs.

dist/client/sw-encrypted-background.js.brView on unpkg

dist/client/assets/chunk-TICWLB2K-P6NXaMX6.js#virtual:normalized:round1View file

•stage = ast_semantic_analysis; reason = ast_parse_error; limitedFiles = 5

High

Semantic Analysis Limited

A bounded semantic-analysis stage reached its safety limit; remaining detectors completed, but this package requires AI review.

dist/client/assets/chunk-TICWLB2K-P6NXaMX6.js#virtual:normalized:round1View on unpkg

scripts/prepare-desktop-runtime.mjsView file

•matchType = normalized_sha256 matchedPackage = termdock@1.4.249 matchedPath = scripts/prepare-desktop-runtime.mjs matchedIdentity = npm:dGVybWRvY2s:1.4.249 similarity = 1.000 summary = normalized source hash matched finalized malicious source

High

Known Malware Source Similarity

Source file is highly similar to a previously finalized malicious package; route for source-aware review.

scripts/prepare-desktop-runtime.mjsView on unpkg

dist/server/agent/pluginPackages.jsView file

•matchType = normalized_sha256 matchedPackage = termdock@1.4.249 matchedPath = [redacted].js matchedIdentity = npm:dGVybWRvY2s:1.4.249 similarity = 1.000 summary = normalized source hash matched finalized malicious source

High

Known Malware Source Similarity

Source file is highly similar to a previously finalized malicious package; route for source-aware review.

dist/server/agent/pluginPackages.jsView on unpkg

dist/server/android/adb.jsView file

•matchType = normalized_sha256 matchedPackage = termdock@1.4.249 matchedPath = dist/server/android/adb.js matchedIdentity = npm:dGVybWRvY2s:1.4.249 similarity = 1.000 summary = normalized source hash matched finalized malicious source

High

Known Malware Source Similarity

Source file is highly similar to a previously finalized malicious package; route for source-aware review.

dist/server/android/adb.jsView on unpkg

dist/server/utils/npmUpdate.jsView file

•matchType = normalized_sha256 matchedPackage = termdock@1.4.249 matchedPath = dist/server/utils/npmUpdate.js matchedIdentity = npm:dGVybWRvY2s:1.4.249 similarity = 1.000 summary = normalized source hash matched finalized malicious source

High

Known Malware Source Similarity

Source file is highly similar to a previously finalized malicious package; route for source-aware review.

dist/server/utils/npmUpdate.jsView on unpkg

dist/client/assets/DiffViewer-BSL3FmLZ.jsView file

•matchType = normalized_sha256 matchedPackage = termdock@1.4.249 matchedPath = dist/client/assets/DiffViewer-zb8C5YLR.js matchedIdentity = npm:dGVybWRvY2s:1.4.249 similarity = 1.000 summary = normalized source hash matched finalized malicious source

High

Known Malware Source Similarity

Source file is highly similar to a previously finalized malicious package; route for source-aware review.

dist/client/assets/DiffViewer-BSL3FmLZ.jsView on unpkg

dist/server/agent/titleNamerCatalog.jsView file

High

Known Malware Source Similarity

Source file is highly similar to a previously finalized malicious package; route for source-aware review.

dist/server/agent/titleNamerCatalog.jsView on unpkg

Source & flagged code

31 flagged · loading source

package.jsonView file

•scripts.postinstall = node scripts/postinstall.mjs

High

Install Time Lifecycle Scripts

Package defines install-time lifecycle scripts.

package.jsonView on unpkg

•scripts.postinstall = node scripts/postinstall.mjs

Medium

Ambiguous Install Lifecycle Script

Install-time lifecycle script is not statically allowlisted and needs review.

package.jsonView on unpkg

dist/server/utils/kicadBoardInspection.jsView file

1import { execFile } from 'child_process'; L2: const KICAD_INSPECTION_SCRIPT = String.raw `

High

Child Process

Package source references child process execution.

dist/server/utils/kicadBoardInspection.jsView on unpkg · L1

Findings

3 Critical24 High7 Medium6 Low

CriticalDownload Execute.desktop-dist/main.js

CriticalTrojan Source Unicodedist/client/assets/terminal-C7X98Amf.js

CriticalTrigger Reachable Dangerous Capability.desktop-dist/main.js

HighInstall Time Lifecycle Scriptspackage.json

HighChild Processdist/server/utils/kicadBoardInspection.js

HighShelldist/server/utils/bootCheck.js

HighEvaldist/client/assets/passwordBootstrap-BvszNW4y.js

HighSame File Env Network Executiondist/server/ptyhost/manager.js

HighSandbox Evasion Gated Capabilityscripts/postinstall.mjs

HighTrigger Reachable External Ai Agent Control Surface Mutationdist/server/agent/installers.js

Affected versions and remediation

This report applies to termdock@1.4.258.

See all versions of termdock for other recorded verdicts.

Review the evidence and your use of termdock@1.4.258 before allowing it. Restrict the permissions described in this report.
Choose an independently verified alternative or release. This report does not establish that other versions are safe.

Evidence last updated: 2026-09-17 18:19:37.510Z (UTC).

Think this verdict is wrong? Dispute it on GitHub or read how reports are produced.