registry / Install hook abuse / termdock / 1.4.296

termdock@1.4.296

A complete web-based terminal application with modern UI

AI Security Review

scanned 15d ago · by lpm-firewall-ai

Source inspection confirmed automatic system package installation from the postinstall hook and CLI boot checks, including sudo use. The inspected behavior is limited to installing tmux, so this is a warning-level install hook risk rather than evidence of malicious intent.

Static reason

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

Trigger

Installing the package when tmux is missing; the CLI boot check can also trigger installation when the application starts.

Impact

May change system packages and request elevated privileges during package installation or application startup.

Mechanism

The scripts detect available package managers and invoke tmux installation commands, using sudo for several Linux managers.

AI rationale

Evidence

scripts/postinstall.mjsdist/server/utils/bootCheck.jsdist/server/cli.js

Decision evidence

public snapshot

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

Evidence for warning

The package runs a postinstall script during installation.
If tmux is absent, the postinstall script attempts to install it through system package managers, including commands marked to use sudo.
Starting the CLI also runs boot checks that can attempt the same privileged tmux installation.

Evidence against

The inspected package manager commands install the application’s stated tmux dependency; no unrelated payload or external recipient was identified in these paths.

Behavioral surface

Source

ChildProcessCryptoDynamicRequireEnvironmentVarsEvalFilesystemNetworkShellWebSocket

Supply chain

HighEntropyStringsMinifiedPossibleObfuscationTelemetryUrlStrings

ManifestNo manifest risk signals triggered.

scanned 264 file(s), 10.9 MB of source, external domains: 127.0.0.1, 192.168.1.23, api.anthropic.com, api.github.com, api.kimi.com, api.openai.com, api.x.ai, bit.ly, brew.sh, bugzilla.mozilla.org, chatgpt.com, chevrotain.io, en.wikipedia.org, generativelanguage.googleapis.com, github.com, jcgt.org, langium.org, reactjs.org, redux.js.org, registry.npmjs.org, term.example.com, termdock-preview.invalid, termdock.invalid, unpkg.com, www.w3.org

Source & flagged code

31 flagged

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/supervisor.jsView file

Lines 3-43javascript

3 * termdock supervisor — 盯住服务子进程，挂了就重启，并把原因记下来。

4 *

5 * 它解决的是两件今天无人负责的事：

6 * 1. 自动更新后新进程没起来（旧实现是发射后不管的 `node -e` bridge，不验证、不重试）；

7 * 2. 运行中崩溃（全仓没有 uncaughtException 处理，server.log 连时间戳都没有）。

8 *

9 * 形态：一个**独立进程**，不是服务内的自重启。自重启活不过 SIGKILL/OOM，

10 * 而那两种恰恰是最需要被兜住的。

11 *

12 * 架构：

13 * ```

14 * td / setsid (launcher，短命)

15 * └─ supervisor (detached 或前台，stdio 指向 server.log + ipc)

16 * └─ server (同进程组，stdio 同样指向 server.log + ipc)

17 * ```

18 * 子进程刻意**不 detached**：同进程组便于整组 kill。但 supervisor 自己死掉时

19 * 不连坐杀服务——丢监督好过丢服务。

20 *

21 * Standalone entry: 只依赖 node stdlib + utils/ 下几个轻量模块，

22 * **绝不 import cli.ts / entry.ts**（那会拖进整个服务运行时）。

23 */

24import { spawn } from 'node:child_process';

25import fs from 'node:fs';

High

Child Process

Package source references child process execution.

dist/server/supervisor.jsView on unpkg · L23

26import path from 'node:path';

27import { fileURLToPath } from 'node:url';

28import { backoffDelayMs } from './utils/backoff.js';

29import { installCrashForensics, isOomSuspect, readRuntimeTail, readServerLogTail } from './utils/crashForensics.js';

30import { probeHealthOnce, HEALTH_PROBE_TIMEOUT_MS } from './utils/healthProbe.js';

31import { writeJsonLogSync } from './utils/serverLogger.js';

32import { SUPERVISOR_STATE_VERSION, classifyChildExit, isReadyMessage, isStartupFailedMessage, isServerIntentMessage, shouldGiveUp, } from './utils/supervisorProtocol.js';

33import { SUPERVISOR_STATE_PATH, STOP_GRACE_MS, isProcessRunning, removeJsonState, writeJsonStateAtomic, } from './utils/termdockState.js';

34export const DEFAULT_SUPERVISOR_TIMING = {

35 readyTimeoutMs: 30_000,

36 healthIntervalMs: 30_000,

37 healthProbeTimeoutMs: HEALTH_PROBE_TIMEOUT_MS,

38 wedgeFailures: 3,

39 killGraceMs: STOP_GRACE_MS,

40 restartDelayMs: 250,

41 crashResetMs: 60_000,

42 maxConsecutiveCrashes: 5,

43 backoffBaseMs: 1_000,

dist/server/utils/bootCheck.jsView file

51const r = spawnSync(cmd, [], { L52: shell: true, L53: timeout: timeoutMs,

High

Shell

Package source references shell execution.

dist/server/utils/bootCheck.jsView on unpkg · L51

•matchType = normalized_sha256 matchedPackage = termdock@1.4.268 matchedPath = dist/server/utils/bootCheck.js matchedIdentity = npm:dGVybWRvY2s:1.4.268 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/bootCheck.jsView on unpkg

dist/client/assets/diffWorker-BP4IBsm9.jsView file

Lines 1-38javascript

1(function(){"use strict";"global"in globalThis||(globalThis.global=globalThis);var we=typeof globalThis<"u"?globalThis:typeof window<"u"?window:typeof global<"u"?

dist/server/utils/version.jsView file

19try { L20: const require_ = createRequire(import.meta.url); L21: const packagePath = path.resolve(currentDir, '..', '..', '..', 'package.json');

Medium

Dynamic Require

Package source references dynamic require/import behavior.

dist/server/utils/version.jsView on unpkg · L19

dist/server/routes/terminal.jsView file

17Trigger-reachable persistence chain: manifest.exports -> dist/server/entry.js -> dist/server/routes/terminal.js L17: import QRCode from 'qrcode'; L18: import { execFile, spawn } from 'child_process'; L19: import { createHash, randomBytes, randomUUID } from 'crypto'; ... L77: const execFileAsync = promisify(execFile); L78: const TERMDOCK_DIR = `${os.homedir()}/.termdock`; L79: const automationStore = new AutomationStore(`${TERMDOCK_DIR}/automations.json`); ... L95: const raw = await fs.promises.readFile(filePath, 'utf-8'); L96: return JSON.parse(raw); L97: } ... L127: const require_ = createRequire(import.meta.url); L128: // dist/server/routes/terminal.js → ../../../package.json L129: const pkg = require_(path.join(__dirname || '', '..', '..', '..', 'package.json'));

High

Trigger Reachable Persistence

A manifest entrypoint or package-local install chain reaches persistence behavior.

dist/server/routes/terminal.jsView on unpkg · L17

17import QRCode from 'qrcode'; L18: import { execFile, spawn } from 'child_process'; L19: import { createHash, randomBytes, randomUUID } from 'crypto'; ... L77: const execFileAsync = promisify(execFile); L78: const TERMDOCK_DIR = `${os.homedir()}/.termdock`; L79: const automationStore = new AutomationStore(`${TERMDOCK_DIR}/automations.json`); ... L95: const raw = await fs.promises.readFile(filePath, 'utf-8'); L96: return JSON.parse(raw); L97: } ... L127: const require_ = createRequire(import.meta.url); L128: // dist/server/routes/terminal.js → ../../../package.json L129: const pkg = require_(path.join(__dirname || '', '..', '..', '..', 'package.json'));

Medium

Install Persistence

Source writes installer persistence such as shell profile or service configuration.

dist/server/routes/terminal.jsView on unpkg · L17

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) {

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.268 matchedPath = scripts/postinstall.mjs matchedIdentity = npm:dGVybWRvY2s:1.4.268 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.268 matchedPath = dist/server/agent/installers.js matchedIdentity = npm:dGVybWRvY2s:1.4.268 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.268 matchedPath = dist/server/cli.js matchedIdentity = npm:dGVybWRvY2s:1.4.268 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

dist/client/shell-integration/termdock.bashView file

•path = dist/client/shell-integration/termdock.bash kind = build_helper sizeBytes = 3514 magicHex = [redacted]

Medium

Ships Build Helper

Package ships non-JavaScript build or shell helper files.

dist/client/shell-integration/termdock.bashView on unpkg

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

•path = dist/client/sw-encrypted-background.js.br kind = high_entropy_blob sizeBytes = 65011 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 = 65011 magicHex = [redacted]

Medium

Ships Compressed Blob

Package ships compressed or archive-like blobs.

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

scripts/android-bitrate/bitrate.jarView file

•path = scripts/android-bitrate/bitrate.jar kind = nested_archive_needs_inspection sizeBytes = 2609 magicHex = [redacted]

Low

Nested Archive Needs Inspection

Package ships a nested archive or MCP bundle that was inventoried but not recursively analyzed.

scripts/android-bitrate/bitrate.jarView on unpkg

dist/client/assets/defaultLocale-CrowFXzY.js#virtual:normalized:round1View file

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

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/defaultLocale-CrowFXzY.js#virtual:normalized:round1View on unpkg

dist/server/agent/pluginPackages.jsView file

•matchType = normalized_sha256 matchedPackage = termdock@1.4.268 matchedPath = [redacted].js matchedIdentity = npm:dGVybWRvY2s:1.4.268 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.268 matchedPath = dist/server/android/adb.js matchedIdentity = npm:dGVybWRvY2s:1.4.268 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/android/scrcpy.jsView file

•matchType = normalized_sha256 matchedPackage = termdock@1.4.268 matchedPath = dist/server/android/scrcpy.js matchedIdentity = npm:dGVybWRvY2s:1.4.268 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/scrcpy.jsView on unpkg

dist/server/utils/npmUpdate.jsView file

•matchType = normalized_sha256 matchedPackage = termdock@1.4.268 matchedPath = dist/server/utils/npmUpdate.js matchedIdentity = npm:dGVybWRvY2s:1.4.268 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-BUCYxg27.jsView file

•matchType = normalized_sha256 matchedPackage = termdock@1.4.268 matchedPath = dist/client/assets/DiffViewer-CYEoT3NM.js matchedIdentity = npm:dGVybWRvY2s:1.4.268 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-BUCYxg27.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

dist/server/android/recording.jsView file

•matchType = normalized_sha256 matchedPackage = termdock@1.4.268 matchedPath = dist/server/android/recording.js matchedIdentity = npm:dGVybWRvY2s:1.4.268 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/recording.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/supervisor.jsView file

23*/ L24: import { spawn } from 'node:child_process'; L25: import fs from 'node:fs';

High

Child Process

Package source references child process execution.

dist/server/supervisor.jsView on unpkg · L23

Findings

1 Critical23 High8 Medium8 Low

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

HighInstall Time Lifecycle Scriptspackage.json

HighChild Processdist/server/supervisor.js

HighShelldist/server/utils/bootCheck.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

HighSpawned Bundled Service Listenerdist/server/cli.js

HighTrigger Reachable Persistencedist/server/routes/terminal.js

HighRuntime Package Installscripts/ensure-node-pty.cjs

High

Affected versions and remediation

This report applies to termdock@1.4.296.

See all versions of termdock for other recorded verdicts.

Review the evidence and your use of termdock@1.4.296 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-10-08 15:11:20.028Z (UTC).

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