registry / Persistence / aicodeman / 1.14.0

aicodeman@1.14.0

Mission control for AI coding agents - run 20 autonomous agents with real-time monitoring and session persistence

AI Security Review

scanned 3mo ago · by lpm-firewall-ai

The package has a real install-time background-launch risk, warranting a warning. Source inspection does not support the scanner's claim of malicious AI-agent control hijacking or a publish block.

Static reason

High-risk behavior combination matched malicious policy.; previous stored version diff introduced dangerous source

Trigger

npm postinstall, unless `CI` or `CODEMAN_NO_AUTOSTART` is set.

Impact

Unexpected background process and local AI-agent-management surface after installation.

Mechanism

install-time detached local web-server launch

AI rationale

The package has a real install-time background-launch risk, warranting a warning. Source inspection does not support the scanner's claim of malicious AI-agent control hijacking or a publish block.

Evidence

package.jsonscripts/postinstall.jsdist/index.jsdist/web/server.jsdist/hooks-config.jsdist/web/self-update.js

Network endpoints1

api.github.com/repos/${owner}/${repo}/releases/latest

Decision evidence

public snapshot

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

Evidence for warning

`scripts/postinstall.js` starts a detached `dist/index.js web` process during npm postinstall unless CI/opt-out.
Postinstall probes local ports and commands, then waits for a localhost server.
Runtime can create Codeman-managed Claude hook configuration only when users create/manage cases.

Evidence against

No install-time write to `.claude`, `.codex`, or other foreign agent-control configuration was found.
The auto-started server defaults to `127.0.0.1`; non-loopback binding is an explicit runtime option.
Observed update network call is a user-triggered GitHub release check for git installs.
No credential harvesting or exfiltration endpoint was found in inspected lifecycle/runtime code.

Behavioral surface

Source

ChildProcessCryptoDynamicRequireEnvironmentVarsFilesystemNativeBindingsNetworkShellWebSocket

Supply chain

Source & flagged code

14 flagged

package.jsonView file

Lines 1-33json

2 "name": "aicodeman",

3 "version": "1.14.0",

4 "description": "Mission control for AI coding agents - run 20 autonomous agents with real-time monitoring and session persistence",

5 "type": "module",

6 "main": "dist/index.js",

7 "types": "dist/index.d.ts",

8 "bin": {

9 "aicodeman": "./dist/index.js",

10 "codeman": "./dist/index.js"

11 },

12 "scripts": {

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

High

Install Time Lifecycle Scripts

Package defines install-time lifecycle scripts.

package.jsonView on unpkg · L13

Medium

Ambiguous Install Lifecycle Script

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

package.jsonView on unpkg · L13

14 "build": "node scripts/build.mjs",

15 "build:gesture": "node scripts/build-gesture-bundle.mjs",

16 "start": "NODE_COMPILE_CACHE=${HOME}/.codeman/compile-cache node dist/index.js",

17 "dev": "tsx src/index.ts web",

18 "web": "node dist/index.js web",

19 "clean": "rm -rf dist",

20 "test": "vitest run --config config/vitest.config.ts",

21 "test:watch": "vitest --config config/vitest.config.ts",

22 "test:coverage": "vitest run --config config/vitest.config.ts --coverage",

23 "test:ci": "vitest run --config config/vitest.ci.config.ts",

24 "check:frontend-syntax": "node scripts/check-frontend-syntax.mjs",

25 "fix:node-pty": "node scripts/fix-node-pty.mjs",

26 "typecheck": "tsc --noEmit",

27 "lint": "eslint --config config/eslint.config.js 'src/**/*.ts'",

28 "lint:fix": "eslint --config config/eslint.config.js 'src/**/*.ts' --fix",

29 "format": "prettier --write 'src/**/*.ts' 'src/web/public/**/*.{js,css,html,json}'",

30 "format:check": "prettier --check 'src/**/*.ts' 'src/web/public/**/*.{js,css,html,json}'",

31 "check:public-assets": "node scripts/check-public-assets.mjs",

32 "capture:subagents": "node scripts/capture-subagent-screenshots.mjs",

33 "changeset": "changeset",

dist/ai-checker-base.jsView file

Lines 4-44javascript

4 * Provides shared functionality for AI-powered checkers that spawn fresh Claude CLI

5 * sessions to analyze terminal output. This base class handles:

6 * - Mux session spawning and cleanup

dist/remote-hosts.jsView file

Lines 1-26javascript

1import { existsSync, mkdirSync } from 'node:fs';

2import fs from 'node:fs/promises';

3import { join } from 'node:path';

4import { homedir } from 'node:os';

dist/web/self-update.jsView file

Lines 3-53javascript

3 *

4 * Powers App Settings → Updates. Codeman is installed as a git clone and run

5 * under systemd (Linux) or launchd (macOS); updating means `git checkout <release

scripts/postinstall.jsView file

Lines 1-43javascript

1#!/usr/bin/env node

3/**

4 * Codeman postinstall verification script

5 * Runs after `npm install` to check environment readiness

6 */

8import { execSync, spawn } from 'child_process';

9import { existsSync } from 'fs'

dist/service-installer.jsView file

26Trigger-reachable persistence chain: scripts.start -> dist/index.js -> dist/cli.js -> dist/service-installer.js L26: * The file writers are pure string builders so they can be unit-tested without L27: * touching launchctl/systemctl. L28: * ... L30: */ L31: import { execFileSync } from 'node:child_process'; L32: import { existsSync, mkdirSync, unlinkSync, writeFileSync } from 'node:fs'; ... L168: export function detectServiceKind() { L169: if (process.platform === 'darwin') L170: return 'launchd'; ... L176: return kind === 'launchd' L177: ? join(homedir(), 'Library', 'LaunchAgents', `${LAUNCHD_LABEL}.plist`) L178: : join(homedir(), '.config', 'systemd', 'user', SYSTEMD_UNIT);

High

Trigger Reachable Persistence

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

dist/service-installer.jsView on unpkg · L26

dist/web/public/gesture/wasm/vision_wasm_nosimd_internal.wasmView file

•path = dist/web/public/gesture/wasm/vision_wasm_nosimd_internal.wasm kind = wasm_module sizeBytes = 9448638 magicHex = [redacted]

Medium

Ships Wasm Module

Package ships WebAssembly modules.

dist/web/public/gesture/wasm/vision_wasm_nosimd_internal.wasmView on unpkg

dist/web/public/upload.html.brView file

•path = dist/web/public/upload.html.br kind = compressed_blob sizeBytes = 1836 magicHex = [redacted]

Medium

Ships Compressed Blob

Package ships compressed or archive-like blobs.

dist/web/public/upload.html.brView on unpkg

dist/web/public/panels-ui.1d4203e0.js.brView file

•path = dist/web/public/panels-ui.1d4203e0.js.br kind = high_entropy_blob sizeBytes = 23789 magicHex = [redacted]

High

Ships High Entropy Blob

Package ships high-entropy non-source blobs.

dist/web/public/panels-ui.1d4203e0.js.brView on unpkg

Source & flagged code

14 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/ai-checker-base.jsView file

24*/ L25: import { execSync, spawn as childSpawn } from 'node:child_process'; L26: import { existsSync, readFileSync, unlinkSync, writeFileSync } from 'node:fs';

High

Child Process

Package source references child process execution.

dist/ai-checker-base.jsView on unpkg · L24

Findings

2 Critical7 High8 Medium6 Low

CriticalAi Agent Control Hijackscripts/postinstall.js

CriticalPrevious Version Dangerous Deltadist/web/self-update.js

HighInstall Time Lifecycle Scriptspackage.json

HighChild Processdist/ai-checker-base.js

HighShelldist/remote-hosts.js

HighCross File Remote Execution Contextscripts/postinstall.js

HighTrigger Reachable Persistencedist/service-installer.js

HighRuntime Package Installscripts/postinstall.js

HighShips High Entropy Blobdist/web/public/panels-ui.1d4203e0.js.br

MediumAmbiguous Install Lifecycle Scriptpackage.json

MediumDynamic Requiredist/web/self-update.js

Affected versions and remediation

This report applies to aicodeman@1.14.0.

See all versions of aicodeman for other recorded verdicts.

Review the evidence and your use of aicodeman@1.14.0 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-08-09 00:40:18.215Z (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