registry / @maxiaochao/pi-toolkit / 0.13.5

@maxiaochao/pi-toolkit@0.13.5

Personal pi coding agent toolkit: background tasks, scheduler, /btw, /cache_export, apply_patch, browser automation, and bundled theme/skills.

AI Security Review

scanned 21h ago · by lpm-firewall-ai

The automatic postinstall overwrite of a global agent instruction file creates a concrete configuration risk, even though the inspected replacement text is ordinary guidance. The flagged ws code is ordinary Origin header handling and does not add an attack finding.

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

Installing the package with lifecycle scripts enabled.

Impact

A user's custom global Pi agent instructions may be replaced during installation.

Mechanism

The postinstall script invokes the installer, which compares the global AGENTS.md with the bundled file and writes the bundled file if they differ.

AI rationale

Evidence

package.jsonscripts/install-agents.mjsglobal/AGENTS.md

Decision evidence

public snapshot

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

Evidence for warning

package.json runs the agent installer during postinstall.
The installer writes the bundled file to the global Pi AGENTS.md path when the existing contents differ.
The bundled file contains general coding guidance and says project-specific instructions override it.
The flagged ws code sets a WebSocket Origin header from configured options; the browser skill connects to the local browser debugging endpoint.

Evidence against

The inspected installer behavior seeds a default theme only when missing and installs the package's pi-worktree command into the user's local bin directory.
The flagged ws receiver excerpt shows ordinary protocol and Origin header handling, not an account action or credential transfer.

Behavioral surface

Source

ChildProcessCryptoDynamicRequireEnvironmentVarsFilesystemNetworkShellWebSocket

Supply chain

HighEntropyStrings

Source & flagged code

15 flagged

package.jsonView file

Lines 51-78json

51 "bin": {

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

53 },

54 "peerDependencies": {

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

56 "@earendil-works/pi-coding-agent": ">=1.3.0",

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

58 "typebox": "*"

59 },

60 "dependencies": {

61 "ws": "^8.19.0"

62 },

63 "scripts": {

64 "test": "node tests/package-layout.mjs && node tests/release-check.mjs && node tests/post-release-check.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/openai-account-pool test && npm --prefix packages/scheduler test && npm --prefix packages/background-tasks test && npm --prefix packages/worktree test && node --experimental-strip-types extensions/btw/tests/history.mjs",

65 "test:root": "node tests/package-layout.mjs && node tests/release-check.mjs && node tests/post-release-check.mjs && node --experimental-strip-types extensions/btw/tests/history.mjs",

66 "load-test": "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 && pi -ne -e ./packages/scheduler/extensions/scheduler.ts && pi -ne -e ./packages/background-tasks/extensions/background-tasks.ts && pi -ne -e ./packages/worktree/extensions/worktree.ts && npm --prefix packages/background-tasks run load-test -- --toolkit",

67 "load-test:root": "pi -ne -e ./extensions/btw/index.ts",

68 "release:check": "node scripts/post-release-check.mjs",

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

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

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

High

Install Time Lifecycle Scripts

Package defines install-time lifecycle scripts.

package.jsonView on unpkg · L71

72 },

73 "publishConfig": {

74 "access": "public"

75 },

76 "license": "MIT"

77}

packages/worktree/tests/extension.test.mjsView file

Lines 37-77javascript

37 let releaseExec;

38 let markExecStarted;

39 const execStarted = new Promise(resolve => { markExecStarted = resolve; });

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/background-tasks/tests/tui-smoke.pyView file

•path = packages/background-tasks/tests/tui-smoke.py kind = payload_in_excluded_dir sizeBytes = 8185 magicHex = [redacted]

High

Payload In Excluded Dir

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

packages/background-tasks/tests/tui-smoke.pyView on unpkg

•path = packages/background-tasks/tests/tui-smoke.py kind = build_helper sizeBytes = 8185 magicHex = [redacted]

Medium

Ships Build Helper

Package ships non-JavaScript build or shell helper files.

packages/background-tasks/tests/tui-smoke.pyView 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

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

•matchType = normalized_sha256 matchedPackage = @maxiaochao/pi-toolkit@0.13.4 matchedPath = skills/web-browser/scripts/start.js matchedIdentity = npm:QG1heGlhb2NoYW8vcGktdG9vbGtpdA:0.13.4 similarity = 1.000 summary = normalized source hash matched finalized malicious source

High