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

@phnx-labs/agents-cli@1.23.4

⚠ Under review

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 source inspected does not substantiate the scanner’s malicious label, but the required clean citations exceed the schema’s 16-citation limit and a required path cannot be cited as UTF-8 source. Manual review is therefore appropriate under the supplied decision rules.

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

Package installation runs the postinstall hook; shell configuration changes depend on the initialization environment or interactive user input.

Impact

No malicious impact was confirmed from the inspected source; the review remains unresolved because required citation coverage cannot fit the output limit.

Mechanism

The inspected code creates CLI shims and may add their directory to PATH. The agent-related excerpts do not establish unauthorized control of an agent or credential transmission.

AI rationale

Evidence

scripts/postinstall.js

Decision evidence

public snapshot

AI called this Manual Review at 72.0% confidence as Unknown with medium false-positive risk.

AI review observations

package.json defines a postinstall hook that runs scripts/postinstall.js.
The hook’s shell initialization branch appends a PATH entry only when AGENTS_INIT_SHELL is set; the interactive branch asks before changing shell configuration.
The agent-related findings inspected include Claude settings inspection, a session test fixture, Codex auth-file reading, and agent metadata; these excerpts alone do not establish an attack.
A clean verdict requires citations for 23 distinct paths, exceeding the 16-citation limit; dist/lib/session/discover.js is also reported as non-UTF-8 and cannot support a clean citation.

Evidence against

Local postinstall exits after creating the user directory and printing a setup command.
The inspected shell-configuration paths concern the CLI’s own shims and PATH setup; no credential exfiltration or destructive action was established.

Behavioral surface

Source

ChildProcessCryptoDynamicRequireEnvironmentVarsFilesystemNetwork

Source & flagged code

25 flagged

package.jsonView file

Lines 28-68json

28 "CHANGELOG.md",

29 "README.md",

30 "LICENSE"

31 ],

32 "publishConfig": {

33 "provenance": true

34 },

35 "repository": {

36 "type": "git",

37 "url": "git+https://github.com/phnx-labs/agi-cli.git"

38 },

39 "homepage": "https://agents-cli.sh",

40 "bugs": {

41 "url": "https://github.com/phnx-labs/agi-cli/issues"

42 },

43 "scripts": {

44 "build": "tsc && rm -rf 'dist/lib/menubar/MenubarHelper.app' && ([ -f 'bin/agents-macos' ] && mkdir -p dist/bin && cp -f 'bin/agents-macos' 'dist/bin/agents' && chmod 755 'dist/bin/agents' || true)",

45 "build:bin": "scripts/build-bin.sh",

46 "prepare": "npm run build",

47 "prepack": "cp ../README.md README.md",

48 "postinstall": "node scripts/postinstall.js",

High

Install Time Lifecycle Scripts

Package defines install-time lifecycle scripts.

package.jsonView on unpkg · L48

Medium

Ambiguous Install Lifecycle Script

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

package.jsonView on unpkg · L48

49 "dev": "tsx src/index.ts",

50 "changelog": "bun scripts/gen-changelog.ts",

51 "gen:index": "bun scripts/gen-command-index.ts",

52 "verify:index": "bash scripts/verify-command-index.sh",

53 "start": "node dist/index.js",

54 "test": "TZ=UTC node ./node_modules/vitest/vitest.mjs run",

55 "bench": "node ./node_modules/vitest/vitest.mjs bench --run",

56 "typecheck:bench": "tsc --noEmit --ignoreConfig --skipLibCheck --module esnext --moduleResolution bundler --target es2022 --strict --esModuleInterop --lib es2022 --types node src/lib/*.bench.ts src/lib/**/*.bench.ts",

57 "test:remote": "scripts/sandbox.sh test",

58 "verify-docs": "scripts/verify-docs.sh",

59 "test:watch": "node ./node_modules/vitest/vitest.mjs"

60 },

61 "keywords": [

62 "agents",

63 "cli",

64 "dotfiles",

65 "claude",

66 "codex",

67 "cursor",

68 "opencode",

dist/bootstrap.jsView file

Lines 272-312javascript

272async function promptUpgrade(latestVersion) {

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

274 const {

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

Lines 1-25javascript

1import { exec } from 'child_process';

2import * as fs from 'fs';

3import * as path from 'path';

dist/lib/sqlite.jsView file

Lines 1-22javascript

1import { createRequire } from 'module';

2const isBun = typeof globalThis.Bun !== 'undefined';

3const require = createRequire(

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 = 26

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

•matchType = normalized_sha256 matchedPackage = @phnx-labs/agents-cli@1.22.109 matchedPath = dist/lib/self-update.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/self-update.jsView 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

Source & flagged code

25 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

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

High

Child Process

Package source references child process execution.

dist/bootstrap.jsView on unpkg · L292

Findings

1 Critical19 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/self-update.js

Affected versions and remediation

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

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.4 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 07:35:22.573Z (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