registry / @agentrhq/webcmd / 0.2.3

@agentrhq/webcmd@0.2.3

Turn websites, browser sessions, desktop apps, and local tools into deterministic CLI surfaces for humans and AI agents.

AI Security Review

scanned 2h ago · by lpm-firewall-ai

LPM treats this as warn-only first-party agent extension lifecycle risk. No confirmed malicious attack surface was established. The package has first-party lifecycle setup and runtime plugin/adapter loading under ~/.webcmd, which is package-aligned but security-sensitive.

Static reason

One or more suspicious static signals were detected.; previous stored version diff introduced dangerous source

Trigger

global npm install, webcmd runtime startup, or explicit webcmd skills/plugin commands

Impact

Package-owned configuration and adapters may be created, cleaned, or loaded; no unconsented foreign agent hijack or exfiltration was found.

Mechanism

first-party home-directory setup plus user/plugin adapter loading

Rationale

Static source inspection shows package-aligned lifecycle setup and explicit extension-management capabilities, not concrete malicious behavior. Because install/runtime extension surfaces are security-sensitive, warn rather than block.

Evidence

package.jsonscripts/postinstall.jsscripts/fetch-adapters.jsdist/src/main.jsdist/src/discovery.jsdist/src/skills.jsdist/src/external.jsdist/src/update-check.js~/.zsh/completions/_webcmd~/.bash_completion.d/webcmd~/.config/fish/completions/webcmd.fish~/.webcmd/spotify.env~/.webcmd/clis~/.webcmd/adapter-manifest.json~/.webcmd/node_modules/@agentrhq/webcmd~/.webcmd/plugins~/.agents/skills/<skill>~/.codex/skills/<skill>~/.claude/skills/<skill>

Network endpoints3

127.0.0.1:9777/shutdowninvalid.example/webcmd/latestinvalid.example/webcmd/releases

Decision evidence

public snapshot

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

Evidence for warning

package.json runs postinstall and preuninstall lifecycle scripts.
scripts/postinstall.js writes shell completion files and ~/.webcmd/spotify.env on global install.
scripts/fetch-adapters.js can delete package-owned ~/.webcmd/clis overrides and legacy ~/.webcmd shim files on global/explicit/first-run sync.
dist/src/discovery.js imports user/plugin JS from ~/.webcmd/clis and ~/.webcmd/plugins at runtime.
dist/src/skills.js can symlink bundled skills into .agents/.codex/.claude skills folders, but only via explicit webcmd skills install/update commands.

Evidence against

No install-time mutation of foreign/broad AI-agent control files was found.
postinstall is gated to global installs for completions and adapter sync; it does not fetch remote code.
dist/src/update-check.js has update checks disabled and points to invalid.example placeholders.
dist/src/external.js uses execFileSync/spawnSync for user-invoked external CLI passthrough and rejects shell operators in install commands.
Network access and browser automation are core package functionality and mostly user-invoked adapters.
No credential harvesting, exfiltration endpoint, destructive broad filesystem action, or stealth persistence found.

Behavioral surface

Source

ChildProcessCryptoDynamicRequireEnvironmentVarsEvalFilesystemNetworkShellWebSocket

Supply chain

HighEntropyStringsTelemetryUrlStrings

ManifestNo manifest risk signals triggered.

scanned 1,305 file(s), 7.17 MB of source, external domains: 127.0.0.1, a.com, a.example, a9.com, aave.com, accounts.google.com, accounts.pixiv.net, accounts.spotify.com, ads.example, api.chess.com, api.coingecko.com, api.dictionaryapi.dev, api.example, api.example.com, api.fda.gov, api.github.com, api.grok.com, api.llama.fi, api.manus.im, api.npmjs.org, api.nuget.org, api.openalex.org, api.osv.dev, api.semanticscholar.org, api.slock.ai, api.spotify.com, api.stackexchange.com, api.test, api.tvmaze.com, api2.openreview.net, app.example, app.mercury.com, app.slock.ai, archive.org, arxiv.org, assets.bwbx.io, assets.grok.com, auth.band.us, auth.openai.com, azuresearch-usnc.nuget.org, b.example, bitcoin.org, blinkit.com, browser.example.com, ca.linkedin.com, cdn.example.com, cdn.example.invalid, cdn.grofers.com, cdn.openai.com, cdn.site.com

Source & flagged code

11 flagged

package.jsonView file

Lines 32-72json

32 "clis/",

33 "skills/**",

34 "cli-manifest.json",

35 "scripts/",

36 "README.md",

37 "LICENSE",

38 "NOTICE"

39 ],

40 "scripts": {

41 "dev": "tsx src/main.ts",

42 "dev:bun": "bun src/main.ts",

43 "build": "npm run clean-dist && npm run copy-yaml && npm run compile && npm run build-manifest",

44 "compile": "tsc --build && node -e \"require('fs').chmodSync('dist/src/main.js', 0o755)\"",

45 "build-manifest": "tsx src/build-manifest.ts",

46 "clean-dist": "node scripts/clean-dist.cjs",

47 "copy-yaml": "node scripts/copy-yaml.cjs",

48 "generate-release-notes": "tsx scripts/generate-release-notes.ts",

49 "start": "node dist/src/main.js",

50 "start:bun": "bun dist/src/main.js",

51 "preuninstall": "node -e \"fetch('http://127.0.0.1:9777/shutdown',{method:'POST',headers:{'X-Webcmd':'1'},signal:AbortSignal.timeout(3000)}).catch(()=>{})\" || true",

52 "postinstall": "node scripts/postinstall.js || true; node scripts/fetch-adapters.js || true",

High

Install Time Lifecycle Scripts

Package defines install-time lifecycle scripts.

package.jsonView on unpkg · L52

Medium

Ambiguous Install Lifecycle Script

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

package.jsonView on unpkg · L52

53 "typecheck": "tsc --noEmit",

54 "prepare": "[ -d src ] && npm run build || true",

55 "prepublishOnly": "npm run build",

56 "test": "vitest run --project unit --project adapter",

57 "test:bun": "bun vitest run --project unit --project adapter",

58 "test:adapter": "vitest run --project adapter",

59 "test:all": "vitest run",

60 "test:e2e": "vitest run --project e2e-fixed-port --project e2e",

61 "advise:listing-id-pairing": "node scripts/check-listing-id-pairing.mjs",

62 "check:package-bin": "node scripts/check-package-bin.mjs",

63 "check:silent-column-drop": "node scripts/check-silent-column-drop.mjs",

64 "check:typed-error-lint": "node scripts/check-typed-error-lint.mjs"

65 },

66 "keywords": [

67 "cli",

68 "browser",

69 "web",

70 "ai"

71 ],

72 "author": "AgentR",

dist/src/external.test.jsView file

Lines 1-29javascript

1import { beforeEach, describe, expect, it, vi } from 'vitest';

2import * as fs from 'node:fs';

3import * as path from 'node:path';

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

5import

dist/src/browser.test.jsView file

Lines 274-298javascript

274 expect(js).toContain('__playwright');

275 expect(js).toContain('__puppeteer');

276 expect(js).toContain('getOwnPropertyNames');

277 expect(js).toContain('cdc_');

278 // 7. CDP stack trace cleanup

dist/src/discovery.jsView file

Lines 237-277javascript

237 return;

238 }

239 const entries = await fs.promises.readdir(dir, { withFileTypes: true });

240 const sitePromises = entries

241 .filter(entry => entry.isDirectory

clis/grok/image.jsView file

Lines 1-26javascript

1import * as fs from 'node:fs';

2import * as path from 'node:path';

3import * as crypto from 'node:crypto';

4import { cli, Strategy } from '@agentrhq/webcmd/registry';

scripts/postinstall.jsView file

Lines 1-27javascript

1#!/usr/bin/env node

3/**

4 * postinstall script — install shell completion files and print setup instructions.

5 *

6 * Detects the user's default shell and writes the completion script to the

7 * standard completion directory. For zsh and bash, the script prints manual

8 * instructions instead of modifying rc files (~/.zshrc, ~/.bashrc) — this

9 * avoids breaking multi-line shell commands and other fragile rc structures.

Medium

Install Persistence

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

scripts/postinstall.jsView on unpkg · L7

dist/src/cli.jsView file

62Cross-file remote execution chain: dist/src/cli.js spawns dist/src/browser/network-interceptor.js; helper contains network access plus dynamic code execution. L62: function isInteractiveInstall(opts) { L63: return !opts.json && process.stdin.isTTY === true && process.stdout.isTTY === true; L64: } ... L165: try { L166: body = JSON.parse(preview); L167: } ... L195: catch { L196: if (process.env.WEBCMD_VERBOSE) L197: log.warn(`[network] Failed to parse interceptor buffer: ${typeof raw === 'string' ? raw.slice(0, 200) : String(raw)}`); ... L213: invalid_filter: EXIT_CODES.USAGE_ERROR, L214: invalid_max_body: EXIT_CODES.USAGE_ERROR, L215: };

High

Cross File Remote Execution Context

Source spawns a local helper that also contains network and dynamic execution context; review data flow before blocking.

dist/src/cli.jsView on unpkg · L62

dist/src/release-notes.jsView file

•matchType = previous_version_dangerous_delta matchedPackage = @agentrhq/webcmd@0.2.2 matchedIdentity = npm:QGFnZW50cmhxL3dlYmNtZA:0.2.2 similarity = 0.975 summary = stored previous version shares package body but lacks this dangerous source file

Critical

Previous Version Dangerous Delta

This package version adds a dangerous source file absent from the previous stored version; route for source-aware review.

dist/src/release-notes.jsView on unpkg

dist/src/observation/redaction.test.jsView file

28patternName = generic_password severity = medium line = 28 matchedText = password...D]',

Medium

Secret Pattern

Hardcoded password in dist/src/observation/redaction.test.js

dist/src/observation/redaction.test.jsView on unpkg · L28

Source & flagged code

11 flagged · loading source

package.jsonView file

•scripts.postinstall = node scripts/postinstall.js || true; node scripts/fetch-adapters.js || true

High

Install Time Lifecycle Scripts

Package defines install-time lifecycle scripts.

package.jsonView on unpkg

•scripts.postinstall = node scripts/postinstall.js || true; node scripts/fetch-adapters.js || true

Medium

Ambiguous Install Lifecycle Script

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

package.jsonView on unpkg

dist/src/external.test.jsView file

9})); L10: vi.mock('node:child_process', () => ({ L11: spawnSync: vi.fn(),

High

Child Process

Package source references child process execution.

dist/src/external.test.jsView on unpkg · L9

115expect(spawnMock).toHaveBeenNthCalledWith(1, 'tg', ['send', 'hello world', '--to', 'a"b'], { stdio: 'inherit' }); L116: expect(spawnMock).toHaveBeenNthCalledWith(2, 'tg send "hello world" --to "a""b"', { stdio: 'inherit', shell: true }); L117: expect(process.exitCode).toBe(0);

High

Shell

Package source references shell execution.

dist/src/external.test.jsView on unpkg · L115

dist/src/browser.test.jsView file

294// Should not throw when parsed L295: expect(() => new Function(js)).not.toThrow(); L296: });

Low

Eval

Package source references a known benign dynamic code generation pattern.

dist/src/browser.test.jsView on unpkg · L294

dist/src/discovery.jsView file

257return; L258: await import(pathToFileURL(filePath).href).catch((err) => { L259: log.warn(`Failed to load module ${filePath}: ${getErrorMessage(err)}`);

Medium

Dynamic Require

Package source references dynamic require/import behavior.

dist/src/discovery.jsView on unpkg · L257

clis/grok/image.jsView file

6L7: const GROK_URL = 'https://grok.com/'; L8: const SESSION_HINT = 'Likely login/auth/challenge/session issue in the existing grok.com browser session.'; ... L204: // refuse direct curl/node downloads. L205: async function fetchImageAsBase64(page, url) { L206: const urlJson = JSON.stringify(url);

Low

Weak Crypto

Package source references weak cryptographic algorithms.

clis/grok/image.jsView on unpkg · L6

scripts/postinstall.jsView file

7* standard completion directory. For zsh and bash, the script prints manual L8: * instructions instead of modifying rc files (~/.zshrc, ~/.bashrc) — this L9: * avoids breaking multi-line shell commands and other fragile rc structures. ... L60: function detectShell() { L61: const shell = process.env.SHELL || ''; L62: if (shell.includes('zsh')) return 'zsh'; ... L77: // Skip in CI environments L78: if (process.env.CI || process.env.CONTINUOUS_INTEGRATION) { L79: return; ... L93: L94: const home = homedir(); L95:

Medium

Install Persistence

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

scripts/postinstall.jsView on unpkg · L7

dist/src/cli.jsView file

High

Cross File Remote Execution Context

Source spawns a local helper that also contains network and dynamic execution context; review data flow before blocking.

dist/src/cli.jsView on unpkg · L62

dist/src/release-notes.jsView file

Critical

Previous Version Dangerous Delta

This package version adds a dangerous source file absent from the previous stored version; route for source-aware review.

dist/src/release-notes.jsView on unpkg

dist/src/observation/redaction.test.jsView file

28patternName = generic_password severity = medium line = 28 matchedText = password...D]',

Medium

Secret Pattern

Hardcoded password in dist/src/observation/redaction.test.js

dist/src/observation/redaction.test.jsView on unpkg · L28

Findings

1 Critical4 High7 Medium8 Low

CriticalPrevious Version Dangerous Deltadist/src/release-notes.js

HighInstall Time Lifecycle Scriptspackage.json

HighChild Processdist/src/external.test.js

HighShelldist/src/external.test.js

HighCross File Remote Execution Contextdist/src/cli.js

MediumAmbiguous Install Lifecycle Scriptpackage.json

MediumDynamic Requiredist/src/discovery.js

MediumNetwork

MediumEnvironment Vars

MediumInstall Persistencescripts/postinstall.js

MediumStructural Risk Force Deep Review

MediumSecret Patterndist/src/observation/redaction.test.js

LowNon Install Lifecycle Scripts

LowScripts Present

LowEvaldist/src/browser.test.js

LowWeak Cryptoclis/grok/image.js

LowFilesystem

LowHigh Entropy Strings

LowTelemetry

LowUrl Strings

Source & flagged code

11 flagged

package.jsonView file

Lines 32-72json

32 "clis/",

33 "skills/**",

34 "cli-manifest.json",

35 "scripts/",

36 "README.md",

37 "LICENSE",

38 "NOTICE"

39 ],

40 "scripts": {

41 "dev": "tsx src/main.ts",

42 "dev:bun": "bun src/main.ts",

43 "build": "npm run clean-dist && npm run copy-yaml && npm run compile && npm run build-manifest",

44 "compile": "tsc --build && node -e \"require('fs').chmodSync('dist/src/main.js', 0o755)\"",

45 "build-manifest": "tsx src/build-manifest.ts",

46 "clean-dist": "node scripts/clean-dist.cjs",

47 "copy-yaml": "node scripts/copy-yaml.cjs",

48 "generate-release-notes": "tsx scripts/generate-release-notes.ts",

49 "start": "node dist/src/main.js",

50 "start:bun": "bun dist/src/main.js",

51 "preuninstall": "node -e \"fetch('http://127.0.0.1:9777/shutdown',{method:'POST',headers:{'X-Webcmd':'1'},signal:AbortSignal.timeout(3000)}).catch(()=>{})\" || true",

52 "postinstall": "node scripts/postinstall.js || true; node scripts/fetch-adapters.js || true",

High

Install Time Lifecycle Scripts

Package defines install-time lifecycle scripts.

package.jsonView on unpkg · L52

Medium

Ambiguous Install Lifecycle Script

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

package.jsonView on unpkg · L52

53 "typecheck": "tsc --noEmit",

54 "prepare": "[ -d src ] && npm run build || true",

55 "prepublishOnly": "npm run build",

56 "test": "vitest run --project unit --project adapter",

57 "test:bun": "bun vitest run --project unit --project adapter",

58 "test:adapter": "vitest run --project adapter",

59 "test:all": "vitest run",

60 "test:e2e": "vitest run --project e2e-fixed-port --project e2e",

61 "advise:listing-id-pairing": "node scripts/check-listing-id-pairing.mjs",

62 "check:package-bin": "node scripts/check-package-bin.mjs",

63 "check:silent-column-drop": "node scripts/check-silent-column-drop.mjs",

64 "check:typed-error-lint": "node scripts/check-typed-error-lint.mjs"

65 },

66 "keywords": [

67 "cli",

68 "browser",

69 "web",

70 "ai"

71 ],

72 "author": "AgentR",

dist/src/external.test.jsView file

Lines 1-29javascript

1import { beforeEach, describe, expect, it, vi } from 'vitest';

2import * as fs from 'node:fs';

3import * as path from 'node:path';

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

5import

dist/src/browser.test.jsView file

Lines 274-298javascript

274 expect(js).toContain('__playwright');

275 expect(js).toContain('__puppeteer');

276 expect(js).toContain('getOwnPropertyNames');

277 expect(js).toContain('cdc_');

278 // 7. CDP stack trace cleanup

dist/src/discovery.jsView file

Lines 237-277javascript

237 return;

238 }

239 const entries = await fs.promises.readdir(dir, { withFileTypes: true });

240 const sitePromises = entries

241 .filter(entry => entry.isDirectory

clis/grok/image.jsView file

Lines 1-26javascript

1import * as fs from 'node:fs';

2import * as path from 'node:path';

3import * as crypto from 'node:crypto';

4import { cli, Strategy } from '@agentrhq/webcmd/registry';

scripts/postinstall.jsView file

Lines 1-27javascript

1#!/usr/bin/env node

3/**

4 * postinstall script — install shell completion files and print setup instructions.

5 *

6 * Detects the user's default shell and writes the completion script to the

7 * standard completion directory. For zsh and bash, the script prints manual

8 * instructions instead of modifying rc files (~/.zshrc, ~/.bashrc) — this

9 * avoids breaking multi-line shell commands and other fragile rc structures.

Medium

Install Persistence

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

scripts/postinstall.jsView on unpkg · L7

dist/src/cli.jsView file

High

Cross File Remote Execution Context

Source spawns a local helper that also contains network and dynamic execution context; review data flow before blocking.

dist/src/cli.jsView on unpkg · L62

dist/src/release-notes.jsView file

Critical

Previous Version Dangerous Delta

This package version adds a dangerous source file absent from the previous stored version; route for source-aware review.

dist/src/release-notes.jsView on unpkg

dist/src/observation/redaction.test.jsView file

28patternName = generic_password severity = medium line = 28 matchedText = password...D]',

Medium

Secret Pattern

Hardcoded password in dist/src/observation/redaction.test.js

dist/src/observation/redaction.test.jsView on unpkg · L28