registry / @phnx-labs/agents-cli / 1.23.12

@phnx-labs/agents-cli@1.23.12

One CLI for all your AI coding agents - versions, config, cloud dispatch, sessions, and teams (now with first-class Grok Build CLI support)

AI Security Review

scanned 12d ago · by lpm-firewall-ai

The postinstall hook can start this package's own persistent daemon during a global install, with a fallback that treats an unavailable enablement check as enabled. This supports a warning for agent extension lifecycle risk, not a finding of a concrete attack.

Static reason

High-risk behavior combination matched malicious policy.; source matched previously finalized malicious package; routed for review; previous stored version diff introduced dangerous source

Trigger

Global npm installation on Linux or macOS, unless CI or AGENTS_NO_HEAL disables the hook behavior.

Impact

The package can keep a background process running after installation; the inspected behavior does not establish data theft or an unrelated control-surface change.

Mechanism

The postinstall hook checks daemon state and configuration, then starts the package daemon when enabled or when the configuration check is unavailable.

AI rationale

Evidence

package.jsonscripts/postinstall.jsdist/lib/daemon/daemon.js

Decision evidence

public snapshot

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

Evidence for warning

The package manifest runs scripts/postinstall.js after installation.
On global installs, the postinstall flow reaches daemon healing on Linux and macOS unless CI or AGENTS_NO_HEAL disables it.
The hook treats the daemon as enabled when its configuration check is unavailable, then starts it if it is not already running.
The behavior starts this package's own daemon; the inspected excerpts do not establish an unrelated recipient or data exfiltration.

Evidence against

Behavioral surface

Source

ChildProcessCryptoDynamicRequireEnvironmentVarsFilesystemNetworkShell

Supply chain

HighEntropyStringsUrlStrings

ManifestNo manifest risk signals triggered.

scanned 823 file(s), 7.26 MB of source, external domains: 127.0.0.1, ai.azure.com, anthropic.com, antigravity.google, api.anthropic.com, api.cloudflare.com, api.cursor.com, api.deepinfra.com, api.example.com, api.factory.ai, api.github.com, api.hetzner.cloud, api.kimi.com, api.linear.app, api.meta.ai, api.openai.com, api.prix.dev, app.factory.ai, app.warp.dev, aws.amazon.com, cloud.google.com, cloudcode-pa.googleapis.com, code.kimi.com, console.anthropic.com, console.hetzner.cloud, console.x.ai, cursor.com, daily-cloudcode-pa.googleapis.com, deepinfra.com, dev.meta.ai, docs.openclaw.ai, docs.x.ai, example.com, generativelanguage.googleapis.com, git-scm.com, github.com, gw.corp, hermes-agent.nousresearch.com, id.byphoenix.com, linear.app, login.tailscale.com, nodejs.org, oauth2.googleapis.com, opencode.ai, openrouter.ai, platform.claude.com, prix.dev, raw.githubusercontent.com, registry.modelcontextprotocol.io, registry.npmjs.org

Source & flagged code

24 flagged

package.jsonView file

•scripts.postinstall = node scripts/postinstall.js

High

Install Time Lifecycle Scripts

Package defines install-time lifecycle scripts.

package.jsonView on unpkg

•scripts.postinstall = node scripts/postinstall.js

Medium

Ambiguous Install Lifecycle Script

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

package.jsonView on unpkg

dist/bootstrap.jsView file

Lines 273-313javascript

273async function promptUpgrade(latestVersion, mayPrompt) {

274 const { default: ora } = await import('ora');

275 const { confirm, select } = await import('@inquirer/prompts');

276 const { isInteractiveTerminal, isPromptCancelled } = await import('./commands/utils.js');

277 if (!mayPrompt || !isInteractiveTerminal()) {

278 console.error(chalk.yellow(`Update available: ${VERSION} -> ${latestVersion}. Run: agents upgrade --yes`));

279 return;

280 }

281 const answer = await select({

282 message: `Update available: ${VERSION} -> ${latestVersion}`,

283 choices: [

284 { value: 'now', name: 'Upgrade now' },

285 { value: 'later', name: 'Later' },

286 { value: 'dismiss', name: `Skip ${latestVersion}` },

287 ],

288 });

289 if (answer === 'dismiss') {

290 dismissUpdateVersion(UPDATE_CHECK_FILE, latestVersion);

291 return;

292 }

293 if (answer === 'now') {

294 const { spawnSync } = await import('child_process');

295 let spinner = ora('Resolving package metadata...').start();

High

Child Process

Package source references child process execution.

dist/bootstrap.jsView on unpkg · L293

296 try {

297 const metadata = await fetchNpmPackageMetadata();

298 saveUpdateCheck(UPDATE_CHECK_FILE, metadata.version);

299 spinner.succeed(`Resolved ${NPM_PACKAGE_NAME}@${metadata.version}`);

300 printResolvedPackage(metadata);

301 const approved = await confirm({

302 message: `Install ${NPM_PACKAGE_NAME}@${metadata.version}?`,

303 default: false,

304 });

305 if (!approved) {

306 console.log(chalk.gray('Upgrade cancelled'));

307 return;

308 }

309 spinner = ora('Upgrading...').start();

310 await installResolvedPackage(metadata);

311 spinner.succeed(`Upgraded to ${metadata.version}`);

312 await showWhatsNew(VERSION, metadata.version);

313 console.log();

dist/session-tracker/dist/reader.jsView file

5import { STATE_DIR, parseState, stateFilePath } from './state-file.js'; L6: const execAsync = promisify(exec); L7: const PID_TREE_MAX_DEPTH = 5;

High

Shell

Package source references shell execution.

dist/session-tracker/dist/reader.jsView on unpkg · L5

dist/lib/sqlite.jsView file

2const isBun = typeof globalThis.Bun !== 'undefined'; L3: const require = createRequire(import.meta.url); L4: function loadNodeSqlite() {

Medium

Dynamic Require

Package source references dynamic require/import behavior.

dist/lib/sqlite.jsView on unpkg · L2

dist/lib/platform/ipc.jsView file

Lines 1-9javascript

1import * as crypto from 'crypto';

2export function ipcEndpoint(socketPath, platform = process.platform) {

3 if (platform ===

dist/lib/menubar/install-menubar.jsView file

Lines 1-21javascript

1import { fileURLToPath } from 'url';

2import { execFileSync, spawnSync, spawn } from 'child_process';

3import * as fs from 'fs';

Medium

Install Persistence

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

dist/lib/daemon/testdata/process-view-start.jsView file

Lines 1-23javascript

1import assert from 'node:assert/strict';

2import fs from 'node:fs';

3import path from 'node:path';

4import net from 'node:net'

dist/commands/setup-fleet.jsView file

1import chalk from 'chalk'; L2: import { spawnSync } from 'node:child_process'; L3: import { getCliLaunch } from '../lib/cli-entry.js'; ... L17: const launch = getCliLaunch(args); L18: const res = spawnSync(launch.command, launch.args, { stdio: 'inherit', env: process.env }); L19: if ((res.status ?? 1) === 0) ... L42: console.error(chalk.red('Tailscale is not installed or not on PATH.')); L43: const platform = process.platform; L44: console.log(chalk.bold('\nInstall Tailscale, then re-run `agents setup fleet`:')); ... L46: console.log(chalk.cyan(' brew install --cask tailscale')); L47: console.log(chalk.gray(' or install from https://tailscale.com/download/mac')); L48: }

High

Sandbox Evasion Gated Capability

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

dist/commands/setup-fleet.jsView on unpkg · L1

•matchType = normalized_sha256 matchedPackage = @phnx-labs/agents-cli@1.22.53 matchedPath = dist/commands/setup-fleet.js matchedIdentity = npm:QHBobngtbGFicy9hZ2VudHMtY2xp:1.22.53 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/commands/setup-fleet.jsView on unpkg

dist/lib/daemon/daemon.jsView file

11Install-time code directly mutates a foreign AI-agent control surface: L38: const LOG_ROTATE_COUNT = 3; L39: const PLIST_NAME = 'com.phnx-labs.agents-daemon'; L40: const SYSTEMD_UNIT = 'agents-daemon.service'; ... L73: const dir = getDaemonDir(); L74: fs.mkdirSync(dir, { recursive: true }); L75: return dir; ... L152: export function writeDaemonPid(pid) { L153: fs.writeFileSync(getPidPath(), String(pid), 'utf-8'); L154: } ... L176: try { L177: fs.writeFileSync(getHeartbeatPath(), JSON.stringify(hb), 'utf-8'); L178: } Write operation from scripts/postinstall.js: L11: const HOME = os.homedir(); L12: const USER_DIR = path.join(HOME, '.agents'); L13: const SHIMS_DIR = path.join(USER_DIR, '.cache', 'shims'); ... L67: const script = `#!/bin/sh\nAGENTS_BIN=${shellQuote(AGENTS_BIN)}\nif [ -z "$AGEN

Critical

Ai Agent Control Hijack

Source creates an unconsented AI-agent control surface through install-time mutation or a default unauthenticated remote skill channel.

dist/lib/daemon/daemon.jsView on unpkg · L11

dist/lib/state.jsView file

•Manifest-trigger-reachable source links an external AI-agent control path to a behavior-bearing write operation. import * as fs from 'fs'; import * as path from 'path'; import * as os from 'os'; import * as yaml from 'yaml'; import { stringifydoc } from './yaml-io.js'; import { execfilesync } from 'child_process'; import { ensurelocktarget, atomicwritefilesync, withfilelock } from './fs-atomic.js'; import { default_system_repo, systemreposlug } from './types.js'; import { machineid } from './machine-id.js'; const home = process.env.home ?? os.homedir(); function issamepath(a, b) { try { return fs.realpathsync.native(a) === fs.realpathsync.native(b); } catch { const norm = (p) => process.platform === 'win32' ? path.resolve(p).tolowercase() : path.resolve(p);

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/lib/state.jsView on unpkg

scripts/postinstall.jsView file

7Trigger-reachable persistence chain: scripts.postinstall -> scripts/postinstall.js L7: import * as readline from 'readline'; L8: import { spawnSync } from 'child_process'; L9: import { fileURLToPath } from 'url'; L10: L11: const HOME = os.homedir(); L12: const USER_DIR = path.join(HOME, '.agents'); ... L19: function resolveAgentsBin() { L20: if (process.platform !== 'darwin') return AGENTS_JS_ENTRYPOINT; L21: try { ... L66: const target = path.join(SHIMS_DIR, name); L67: const script = `#!/bin/sh\nAGENTS_BIN=${shellQuote(AGENTS_BIN)}\nif [ -z "$AGENTS_BIN" ] || [ ! -x "$AGENTS_BIN" ]; then\n echo "agents: agents-cli entrypoint missing or not execu... L68: fs.writeFileSync(target, script, { mode: 0o755 });

High

Trigger Reachable Persistence

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

scripts/postinstall.jsView on unpkg · L7

dist/session-tracker/dist/hook.shView file

•path = dist/session-tracker/dist/hook.sh kind = build_helper sizeBytes = 4499 magicHex = [redacted]

Medium

Ships Build Helper

Package ships non-JavaScript build or shell helper files.

dist/session-tracker/dist/hook.shView on unpkg

dist/commands/daemon.js#virtual:normalized:round1View file

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

High

Semantic Analysis Limited

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

dist/commands/daemon.js#virtual:normalized:round1View on unpkg

dist/lib/session/discover.jsView file

•matchType = token_shingles matchedPackage = @phnx-labs/agents-cli@1.22.109 matchedPath = dist/lib/session/discover.js matchedIdentity = npm:QHBobngtbGFicy9hZ2VudHMtY2xp:1.22.109 similarity = 1.000 shingleOverlap = 48 summary = source token shingles overlapped 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/lib/session/discover.jsView on unpkg

dist/lib/tmux/binary.jsView file

•matchType = normalized_sha256 matchedPackage = @phnx-labs/agents-cli@1.22.53 matchedPath = dist/lib/tmux/binary.js matchedIdentity = npm:QHBobngtbGFicy9hZ2VudHMtY2xp:1.22.53 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/lib/tmux/binary.jsView on unpkg

dist/lib/loop.jsView file

•matchType = normalized_sha256 matchedPackage = @phnx-labs/agents-cli@1.22.53 matchedPath = dist/lib/loop.js matchedIdentity = npm:QHBobngtbGFicy9hZ2VudHMtY2xp:1.22.53 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/lib/loop.jsView on unpkg

dist/lib/models.jsView file

•matchType = normalized_sha256 matchedPackage = @phnx-labs/agents-cli@1.22.109 matchedPath = dist/lib/models.js matchedIdentity = npm:QHBobngtbGFicy9hZ2VudHMtY2xp:1.22.109 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/lib/models.jsView on unpkg

dist/lib/session/provenance.jsView file

•matchType = normalized_sha256 matchedPackage = @phnx-labs/agents-cli@1.22.53 matchedPath = dist/lib/session/provenance.js matchedIdentity = npm:QHBobngtbGFicy9hZ2VudHMtY2xp:1.22.53 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/lib/session/provenance.jsView on unpkg

dist/lib/auto-pull.jsView file

•matchType = normalized_sha256 matchedPackage = @phnx-labs/agents-cli@1.22.53 matchedPath = dist/lib/auto-pull.js matchedIdentity = npm:QHBobngtbGFicy9hZ2VudHMtY2xp:1.22.53 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/lib/auto-pull.jsView on unpkg

dist/commands/message.jsView file

•matchType = token_shingles matchedPackage = @phnx-labs/agents-cli@1.22.53 matchedPath = dist/commands/message.js matchedIdentity = npm:QHBobngtbGFicy9hZ2VudHMtY2xp:1.22.53 similarity = 1.000 shingleOverlap = 48 summary = source token shingles overlapped 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/commands/message.jsView on unpkg

dist/lib/teams/forEach.jsView file

•matchType = normalized_sha256 matchedPackage = @phnx-labs/agents-cli@1.22.53 matchedPath = dist/lib/teams/forEach.js matchedIdentity = npm:QHBobngtbGFicy9hZ2VudHMtY2xp:1.22.53 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/lib/teams/forEach.jsView on unpkg

dist/lib/agent-spec/agents.jsView file

•matchType = previous_version_dangerous_delta matchedPackage = @phnx-labs/agents-cli@1.23.10 matchedIdentity = npm:QHBobngtbGFicy9hZ2VudHMtY2xp:1.23.10 similarity = 0.958 summary = stored previous version shares package body but lacks this dangerous source file

High

Previous Version Dangerous Delta

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

dist/lib/agent-spec/agents.jsView on unpkg

Source & flagged code

24 flagged · loading source

package.jsonView file

•scripts.postinstall = node scripts/postinstall.js

High

Install Time Lifecycle Scripts

Package defines install-time lifecycle scripts.

package.jsonView on unpkg

•scripts.postinstall = node scripts/postinstall.js

Medium

Ambiguous Install Lifecycle Script

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

package.jsonView on unpkg

dist/bootstrap.jsView file

293if (answer === 'now') { L294: const { spawnSync } = await import('child_process'); L295: let spinner = ora('Resolving package metadata...').start();

High

Child Process

Package source references child process execution.

dist/bootstrap.jsView on unpkg · L293

Findings

1 Critical18 High7 Medium6 Low

CriticalAi Agent Control Hijackdist/lib/daemon/daemon.js

HighInstall Time Lifecycle Scriptspackage.json

HighChild Processdist/bootstrap.js

HighShelldist/session-tracker/dist/reader.js

HighSame File Env Network Executiondist/lib/daemon/testdata/process-view-start.js

HighSandbox Evasion Gated Capabilitydist/commands/setup-fleet.js

HighTrigger Reachable External Ai Agent Control Surface Mutationdist/lib/state.js

HighTrigger Reachable Persistencescripts/postinstall.js

HighSemantic Analysis Limiteddist/commands/daemon.js#virtual:normalized:round1

HighKnown Malware Source Similaritydist/lib/session/discover.js

Affected versions and remediation

This report applies to @phnx-labs/agents-cli@1.23.12.

See all versions of @phnx-labs/agents-cli for other recorded verdicts.

Review the evidence and your use of @phnx-labs/agents-cli@1.23.12 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-11 14:59:13.452Z (UTC).

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

AI Security Review

Decision evidence

Source & flagged code

Source & flagged code

Findings

Affected versions and remediation

Runtime surface

Behavioral surface

Source & flagged code