termdock@1.4.321
A complete web-based terminal application with modern UI
AI Security Review
scanned 9d ago · by lpm-firewall-aiThe source verifies automatic refresh of existing, outdated agent hooks, which creates a guarded agent extension lifecycle risk. The hook behavior is limited to local status reporting, so the evidence supports a warning rather than a block.
Static reason
High-risk behavior combination matched malicious policy.; source matched previously finalized malicious package; routed for review
Trigger
Starting the Termdock server when a previously installed Termdock hook is outdated.
Impact
External agent configuration can change automatically, affecting when the Termdock status hook runs. The inspected code does not establish credential or prompt transfer.
Mechanism
The startup refresh checks existing hook state and updates Termdock-marked entries to point to the current event emitter.
AI rationale
The source verifies automatic refresh of existing, outdated agent hooks, which creates a guarded agent extension lifecycle risk. The hook behavior is limited to local status reporting, so the evidence supports a warning rather than a block.
Evidence
dist/server/routes/terminal.jsdist/server/agent/installers.jsdist/server/agentHook.js
Decision evidence
public snapshotAI called this Suspicious at 86.0% confidence as Dangerous Capability with medium false-positive risk.
Evidence for warning
- At server startup, Termdock automatically refreshes its agent hooks when they are outdated.
- The refresh is limited to existing Termdock hooks and writes to user-level agent configuration paths, replacing Termdock entries while preserving other hook entries.
- The hook emitter is gated to Termdock or tmux sessions and sends status events to a local terminal.
- Agent hook installation is exposed through a request route; plugin installation requires an explicit CLI option and supplied source.
- The Codex helper searches session directories for a matching file and uses a process check to identify an external writer; the inspected path does not show session-content transfer.
Evidence against
- The automatic refresh is restricted to integrations already marked as Termdock-owned and outdated.
- The inspected hook emitter reports local status and does not establish an outbound data transfer.
Behavioral surface
ChildProcessCryptoDynamicRequireEnvironmentVarsEvalFilesystemNetworkShellWebSocket
HighEntropyStringsMinifiedPossibleObfuscationTelemetryUrlStrings
Source & flagged code
32 flagged · loading sourcepackage.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 unpkgdist/client/assets/app-Bj0N393t.jsView file
2patternName = generic_password
severity = medium
line = 2
Medium
Secret Pattern
Package contains a possible secret pattern.
dist/client/assets/app-Bj0N393t.jsView on unpkg · L2dist/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•matchType = normalized_sha256
matchedPackage = termdock@1.4.268
matchedPath = dist/server/supervisor.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/supervisor.jsView on unpkgdist/server/utils/bootCheck.jsView file
51const r = spawnSync(cmd, [], {
L52: shell: true,
L53: timeout: timeoutMs,
High
•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 unpkgdist/client/assets/diffWorker-BP4IBsm9.jsView file
20?|
L21: |(?![\\s\\S])))+`,"m"),alias:i}}),Object.defineProperty(r.languages.diff,"PREFIXES",{value:n})})(t)}return Sn}var vn,ql;function me(){if(ql)return vn;ql=1,vn=e,e.displayName="marku...
L22: \r]*'|"(?:\\.|[^\\\\"\r
Low
Eval
Package source references a known benign dynamic code generation pattern.
dist/client/assets/diffWorker-BP4IBsm9.jsView on unpkg · L20dist/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 · L19dist/server/routes/terminal.jsView file
28Trigger-reachable persistence chain: manifest.exports -> dist/server/entry.js -> dist/server/routes/terminal.js
L28: import QRCode from 'qrcode';
L29: import { execFile, spawn } from 'child_process';
L30: import { createHash, randomBytes, randomUUID } from 'crypto';
...
L93: const execFileAsync = promisify(execFile);
L94: const TERMDOCK_DIR = `${os.homedir()}/.termdock`;
L95: const automationStore = new AutomationStore(`${TERMDOCK_DIR}/automations.json`);
...
L111: const raw = await fs.promises.readFile(filePath, 'utf-8');
L112: return JSON.parse(raw);
L113: }
...
L143: const require_ = createRequire(import.meta.url);
L144: // dist/server/routes/terminal.js → ../../../package.json
L145: 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 · L2828import QRCode from 'qrcode';
L29: import { execFile, spawn } from 'child_process';
L30: import { createHash, randomBytes, randomUUID } from 'crypto';
...
L93: const execFileAsync = promisify(execFile);
L94: const TERMDOCK_DIR = `${os.homedir()}/.termdock`;
L95: const automationStore = new AutomationStore(`${TERMDOCK_DIR}/automations.json`);
...
L111: const raw = await fs.promises.readFile(filePath, 'utf-8');
L112: return JSON.parse(raw);
L113: }
...
L143: const require_ = createRequire(import.meta.url);
L144: // dist/server/routes/terminal.js → ../../../package.json
L145: 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 · L28dist/server/ptyhost/manager.jsView file
264// must not die with (or be reaped by) this server.
L265: const child = spawn(command, args, {
L266: detached: true,
L267: stdio: 'ignore',
L268: env: process.env,
L269: });
...
L274: return new Promise((resolvePromise, rejectPromise) => {
L275: const conn = net.createConnection(ptyHostSocketPath());
L276: const timer = setTimeout(() => {
High
Same File Env Network Execution
A single source file combines environment access, network access, and code or shell execution; review context before blocking.
dist/server/ptyhost/manager.jsView on unpkg · L264•matchType = normalized_sha256
matchedPackage = termdock@1.4.66
matchedPath = dist/server/ptyhost/manager.js
matchedIdentity = npm:dGVybWRvY2s:1.4.66
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/ptyhost/manager.jsView on unpkgscripts/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 unpkgdist/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 unpkgdist/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 · L4dist/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 });
...
L28: import { getMissingCertificateNames } from './utils/certificateNames.js';
L29: import http from 'http';
L30: import https from 'https';
...
L33: import { createHash, randomUUID } from 'crypto';
L34: import { spawn, spawnSync, execFile } from 'child_process';
L35: 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 · L4scripts/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 · L51dist/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 unpkgdist/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 unpkgscripts/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 unpkgdist/client/assets/App-VAvoVlm2.jsView file
•stage = ast_semantic_analysis; reason = ast_path_work_budget_exceeded; limitedFiles = 8
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/App-VAvoVlm2.jsView on unpkgdist/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 unpkgdist/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 unpkgdist/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 unpkgdist/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 unpkgdist/client/assets/DiffViewer-DOvGC9bh.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-DOvGC9bh.jsView on unpkgdist/server/agent/titleNamerCatalog.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/titleNamerCatalog.jsView on unpkgdist/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 unpkgFindings
1 Critical23 High9 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
HighShips High Entropy Blobdist/client/sw-encrypted-background.js.br
HighSemantic Analysis Limiteddist/client/assets/App-VAvoVlm2.js
HighKnown Malware Source Similaritydist/server/utils/bootCheck.js
HighKnown Malware Source Similarityscripts/postinstall.mjs
HighKnown Malware Source Similaritydist/server/agent/pluginPackages.js
HighKnown Malware Source Similaritydist/server/android/adb.js
HighKnown Malware Source Similaritydist/server/android/scrcpy.js
HighKnown Malware Source Similaritydist/server/utils/npmUpdate.js
HighKnown Malware Source Similaritydist/client/assets/DiffViewer-DOvGC9bh.js
HighKnown Malware Source Similaritydist/server/agent/installers.js
HighKnown Malware Source Similaritydist/server/agent/titleNamerCatalog.js
HighKnown Malware Source Similaritydist/server/android/recording.js
HighKnown Malware Source Similaritydist/server/ptyhost/manager.js
HighKnown Malware Source Similaritydist/server/supervisor.js
MediumAmbiguous Install Lifecycle Scriptpackage.json
MediumSecret Patterndist/client/assets/app-Bj0N393t.js
MediumDynamic Requiredist/server/utils/version.js
MediumNetwork
MediumEnvironment Vars
MediumInstall Persistencedist/server/routes/terminal.js
MediumShips Build Helperdist/client/shell-integration/termdock.bash
MediumShips Compressed Blobdist/client/sw-encrypted-background.js.br
MediumStructural Risk Force Deep Review
LowNon Install Lifecycle Scripts
LowScripts Present
LowEvaldist/client/assets/diffWorker-BP4IBsm9.js
LowFilesystem
LowHigh Entropy Strings
LowTelemetry
LowUrl Strings
LowNested Archive Needs Inspectionscripts/android-bitrate/bitrate.jar
Affected versions and remediation
This report applies to termdock@1.4.321.
See all versions of termdock for other recorded verdicts.
- Review the evidence and your use of termdock@1.4.321 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: .
Think this verdict is wrong? Dispute it on GitHub or read how reports are produced.