registry / @maxiaochao/pi-toolkit / 0.13.3

@maxiaochao/pi-toolkit@0.13.3

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

AI Security Review

scanned 2d ago · by lpm-firewall-ai

The unprompted replacement of a global agent instruction file creates a concrete configuration-loss risk and warrants a warning. The inspected source does not establish a malicious payload or credential transfer.

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 through npm runs its postinstall hook.

Impact

Customized global agent instructions may be lost.

Mechanism

The hook writes the bundled instructions to the global agent directory when the existing file is absent or differs.

AI rationale

Evidence

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

Decision evidence

public snapshot

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

Evidence for warning

The package postinstall hook automatically runs the agent installer.
The installer replaces the global agent instructions when they are missing or differ from the bundled file, without prompting.
The bundled file contains general coding-agent guidance.
The flagged WebSocket code sets protocol and origin headers; its inspected caller obtains the debugger WebSocket URL from a debug endpoint that defaults to localhost.

Evidence against

Behavioral surface

Source

ChildProcessCryptoDynamicRequireEnvironmentVarsFilesystemNetworkShellWebSocket

Supply chain

HighEntropyStringsUrlStrings

ManifestNo manifest risk signals triggered.

scanned 110 file(s), 907 KB of source, external domains: 127.0.0.1, example.com, example.test, github.com

Source & flagged code

14 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.11.22 matchedPath = skills/web-browser/scripts/start.js matchedIdentity = npm:QG1heGlhb2NoYW8vcGktdG9vbGtpdA:0.11.22 similarity = 1.000 summary = normalized source hash matched finalized malicious source

High