registry / AI-agent control-surface risk / @maxiaochao/pi-toolkit / 0.10.5

@maxiaochao/pi-toolkit@0.10.5

Personal pi coding agent toolkit: execution plans, /btw, /cache_export and apply_patch extensions, browser automation, and bundled theme/skills.

AI Security Review

scanned 15d ago · by lpm-firewall-ai

The manifest activates a postinstall script that overwrites a global Pi agent instruction file when it differs from the bundled copy. This is an unconsented install-time change to an AI-agent control surface, so the package meets the block policy.

Static reason

High-risk behavior combination matched malicious policy.; source matched previously finalized malicious package; routed for review

Trigger

Installing the package through npm triggers its postinstall hook.

Impact

This changes a global AI-agent control surface without an explicit setup command and may overwrite user-authored instructions.

Mechanism

The hook writes the bundled AGENTS.md to ~/.pi/agent/AGENTS.md whenever the existing file differs.

Policy narrative

On npm installation, the postinstall hook writes the bundled global AGENTS.md into the user’s Pi agent directory if the existing file differs. This can replace user-authored global agent instructions without an explicit setup action.

AI rationale

Evidence

package.jsonscripts/install-agents.mjsglobal/AGENTS.md~/.pi/agent/AGENTS.md

Decision evidence

public snapshot

AI identified this as a dangerous AI-agent capability at 96.0% confidence with low false-positive risk.

Evidence for policy risk

The package manifest runs scripts/install-agents.mjs automatically after installation.
The postinstall script targets ~/.pi/agent/AGENTS.md and replaces it with the package’s bundled instructions when the files differ.
The bundled file supplies global behavioral guidelines to the Pi agent.

Evidence against

The bundled instructions describe coding practices, and the script also seeds a default theme and installs the package’s pi-worktree command.

Behavioral surface

Source

ChildProcessCryptoEnvironmentVarsFilesystemNetworkShellWebSocket

Supply chain

HighEntropyStringsUrlStrings

Manifest

NoLicense

scanned 79 file(s), 669 KB of source, external domains: 127.0.0.1, example.com, github.com

Source & flagged code

12 flagged

package.jsonView file

Lines 44-70json

44 "./themes"

45 ]

46 },

47 "bin": {

48 "pi-worktree": "packages/worktree/bin/pi-worktree"

49 },

50 "peerDependencies": {

51 "@earendil-works/pi-ai": "*",

52 "@earendil-works/pi-coding-agent": "*",

53 "@earendil-works/pi-tui": "*",

54 "typebox": "*"

55 },

56 "dependencies": {

57 "ws": "^8.19.0"

58 },

59 "scripts": {

60 "test": "node tests/package-layout.mjs && npm --prefix packages/todo test && npm --prefix packages/cache-export test && npm --prefix packages/codex-edit test && npm --prefix packages/herdr-subagents test && npm --prefix packages/worktree test && node --experimental-strip-types extensions/btw/tests/history.mjs",

61 "load-test": "pi -ne -e ./packages/todo/extensions/todo.ts && pi -ne -e ./packages/cache-export/extensions/cache-export.ts && pi -ne -e ./extensions/btw/index.ts && pi -ne -e ./packages/codex-edit/extensions/codex-edit.ts && pi -ne -e ./packages/herdr-subagents/extensions/herdr-subagents.ts",

62 "eval:agents": "node evaluations/agents-md/run.mjs",

63 "eval:agents:test": "node evaluations/agents-md/tests/run-tests.mjs",

64 "postinstall": "node scripts/install-agents.mjs"

High

Install Time Lifecycle Scripts

Package defines install-time lifecycle scripts.

package.jsonView on unpkg · L64

65 },

66 "publishConfig": {

67 "access": "public"

68 }

69}

packages/herdr-subagents/src/herdr.tsView file

Lines 1-21typescript

1import { spawn } from "node:child_process";

High

Child Process

Package source references child process execution.

packages/herdr-subagents/src/herdr.tsView on unpkg · L1

3export interface CreateTabRequest {

4 workspaceId: string;

skills/web-browser/scripts/start.jsView file

Lines 41-81javascript

42const HOME = process.env["HOME"] || homedir();

43const CACHE_ROOT = join(HOME, ".cache", "agent-web"

skills/chrome-cdp/scripts/cdp.mjsView file

Lines 1-32javascript

1#!/usr/bin/env node

2// cdp - lightweight Chrome DevTools Protocol CLI

3// Uses raw CDP over WebSocket, no Puppeteer dependency.

4// Requires Node 22+ (built-in WebSocket).

5//

6// Per-tab persistent daemon: page commands go through a daemon that holds

7// the CDP session open. Chrome's "Allow debugging" modal fires once per

8// daemon (= once per tab). Daemons auto-exit after 20min idle.

10import { readFileSync, writeFileSync, unlinkSync, existsSync, mkdirSync }

scripts/install-agents.mjsView file

Lines 1-21javascript

1// postinstall hook: sync the bundled global AGENTS.md and seed the default theme

2// without overriding a theme the user has already selected.

3import { readFileSync, writeFileSync, mkdirSync, existsSync } from "node:fs";

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

5import { dirname, join } from "node:path";

skills/pdlog/tools/ppmdView file

•path = skills/pdlog/tools/ppmd kind = native_binary sizeBytes = 68456 magicHex = [redacted]

Medium

Ships Native Binary

Package ships native binary artifacts.

skills/pdlog/tools/ppmdView on unpkg

packages/worktree/bin/pi-worktree-completion.bashView file

•path = packages/worktree/bin/pi-worktree-completion.bash kind = build_helper sizeBytes = 1368 magicHex = [redacted]

Medium

Ships Build Helper

Package ships non-JavaScript build or shell helper files.

packages/worktree/bin/pi-worktree-completion.bashView on unpkg

packages/worktree/tests/run-tests.shView file

•path = packages/worktree/tests/run-tests.sh kind = payload_in_excluded_dir sizeBytes = 1413 magicHex = [redacted]

High

Payload In Excluded Dir

Package hides binary, compressed, or executable-looking payloads in test/fixture/hidden paths.

packages/worktree/tests/run-tests.shView on unpkg

packages/codex-edit/tests/generate-test-report.mjs#virtual:string-array:round1View file

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

High

Semantic Analysis Limited

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

packages/codex-edit/tests/generate-test-report.mjs#virtual:string-array:round1View on unpkg

packages/cache-export/tests/e2e-browser.mjsView file

•matchType = normalized_sha256 matchedPackage = @maxiaochao/pi-toolkit@0.9.4 matchedPath = packages/cache-export/tests/e2e-browser.mjs matchedIdentity = npm:QG1heGlhb2NoYW8vcGktdG9vbGtpdA:0.9.4 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.

packages/cache-export/tests/e2e-browser.mjsView on unpkg

Source & flagged code

12 flagged · loading source

package.jsonView file

•scripts.postinstall = node scripts/install-agents.mjs

High

Install Time Lifecycle Scripts

Package defines install-time lifecycle scripts.

package.jsonView on unpkg

packages/herdr-subagents/src/herdr.tsView file

1import { spawn } from "node:child_process"; L2:

High

Child Process

Package source references child process execution.

packages/herdr-subagents/src/herdr.tsView on unpkg · L1

skills/web-browser/scripts/start.jsView file

61L62: function powershellQuote(value) { L63: return `'${String(value).replaceAll("'", "''")}'`;

Findings

1 Critical9 High5 Medium5 Low

CriticalAi Agent Control Hijackscripts/install-agents.mjs

HighInstall Time Lifecycle Scriptspackage.json

HighChild Processpackages/herdr-subagents/src/herdr.ts

HighShellskills/web-browser/scripts/start.js

HighSame File Env Network Executionskills/chrome-cdp/scripts/cdp.mjs

HighPayload In Excluded Dirpackages/worktree/tests/run-tests.sh

HighSemantic Analysis Limitedpackages/codex-edit/tests/generate-test-report.mjs#virtual:string-array:round1

HighKnown Malware Source Similarityskills/chrome-cdp/scripts/cdp.mjs

HighKnown Malware Source Similarityskills/web-browser/scripts/start.js

HighKnown Malware Source Similaritypackages/cache-export/tests/e2e-browser.mjs

Affected versions and remediation

This report applies to @maxiaochao/pi-toolkit@0.10.5.

See all versions of @maxiaochao/pi-toolkit for other recorded verdicts.

Avoid installing @maxiaochao/pi-toolkit@0.10.5. Remove it from direct dependencies and check your lockfile for transitive copies.
Choose an independently verified alternative or release. This report does not establish that other versions are safe.
If this version ran, investigate the affected machine and build environment. Rotate credentials it could access and rebuild from a trusted environment.

Evidence last updated: 2026-10-08 13:13:44.829Z (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

Related packages

Other AI-agent control-surface risk packages

Behavioral surface

Source & flagged code

Related packages

Other AI-agent control-surface risk packages