registry / @maxiaochao/pi-toolkit / 0.11.3

@maxiaochao/pi-toolkit@0.11.3

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

AI Security Review

scanned 9d ago · by lpm-firewall-ai

The postinstall hook changes global Pi agent instructions without a separate setup command, creating an agent configuration lifecycle risk. The inspected behavior is package-aligned setup, so the evidence supports a warning rather than a publish block.

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.

Impact

This changes instructions loaded by later Pi sessions without a separate user-invoked setup command. The inspected hook establishes configuration mutation but no malicious payload or credential disclosure.

Mechanism

The hook writes the bundled AGENTS.md when the global file is absent or differs, and fills in a missing default theme setting.

AI rationale

Evidence

package.jsonscripts/install-agents.mjs~/.pi/agent/AGENTS.md~/.pi/agent/settings.json

Decision evidence

public snapshot

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

Evidence for warning

package.json runs scripts/install-agents.mjs as a postinstall hook.
The hook targets the user's global Pi agent directory and loads the package's bundled AGENTS.md.
It replaces the global AGENTS.md when missing or different from the bundled file.
It creates a default theme setting when settings.json or its theme is missing.

Evidence against

The observed changes are limited to Pi configuration and a default theme; no credential transfer or remote endpoint is established by the inspected hook.

Behavioral surface

Source

ChildProcessCryptoDynamicRequireEnvironmentVarsFilesystemNetworkShellWebSocket

Supply chain

HighEntropyStringsUrlStrings

Manifest

NoLicense

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

Source & flagged code

15 flagged

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/worktree/tests/extension.test.mjsView file

Lines 37-77javascript

37 let releaseExec;

38 let markExecStarted;

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

40 const pi = {

41 on(event, handler) { handlers[event] = handler; },

42 registerCommand(name, command) { handlers[`command:${name}`] = command.handler; },

43 registerTool(tool) { handlers.tool = tool; },

44 async exec(command, args, options) {

45 execCalls.push({ command, args, options });

46 assert.equal(options.cwd, cwd);

47 markExecStarted();

48 if (deferExec) await new Promise(resolve => { releaseExec = resolve; });

49 return {

50 code: 0,

51 stdout: JSON.stringify({ status: "created", path: worktree, branch: "feature", dirty: false }),

52 stderr: "",

53 };

54 },

55 sendUserMessage(message, options) { sent.push({ message, options }); },

56 };

58 const extension = (await import(`${extensionUrl}?test=${Math.random()}`)).default;

59 extension(pi);

Medium

Dynamic Require

Package source references dynamic require/import behavior.

packages/worktree/tests/extension.test.mjsView on unpkg · L57

61 let switchedTo;

62 const ctx = {

63 cwd,

64 sessionManager: {

65 getSessionFile: () => source,

66 usesDefaultSessionDir: () => !customSessionDir,

67 getSessionDir: () => sessions,

68 },

69 ui: { notify: (message, type) => notifications.push({ message, type }) },

70 async waitForIdle() {},

71 async switchSession(path, options) {

72 switchedTo = path;

73 if (cancelled) return { cancelled: true };

74 if (switchError) throw switchError;

75 await options.withSession({

76 ui: ctx.ui,

77 async sendMessage(message, options) { sessionMessages.push({ message, options }); },

scripts/install-agents.mjsView file

1// postinstall hook: sync the bundled global AGENTS.md and seed the default theme L2: // without overriding a theme the user has already selected. L3: import { readFileSync, writeFileSync, mkdirSync, existsSync } from "node:fs"; L4: import { homedir } from "node:os"; ... L11: const agentDir = join(homedir(), ".pi", "agent"); L12: const bundled = readFileSync(join(dirname(fileURLToPath(import.meta.url)), "..", "global", "AGENTS.md"), "utf8"); L13: const agentsTarget = join(agentDir, "AGENTS.md"); L14: const settingsTarget = join(agentDir, "settings.json"); ... L16: if (!existsSync(agentsTarget) || readFileSync(agentsTarget, "utf8") !== bundled) { L17: mkdirSync(dirname(agentsTarget), { recursive: true }); L18: writeFileSync(agentsTarget, bundled, "utf8"); L19: console.log("[pi-toolkit]

Critical

Ai Agent Control Hijack

Source creates an unconsented AI-agent control surface through install-time mutation or a default unauthenticated remote skill channel.

scripts/install-agents.mjsView on unpkg · L1

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 = 1338 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 = 4687 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

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

•matchType = normalized_sha256 matchedPackage = @maxiaochao/pi-toolkit@0.11.5 matchedPath = skills/web-browser/scripts/start.js matchedIdentity = npm:QG1heGlhb2NoYW8vcGktdG9vbGtpdA:0.11.5 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.

skills/web-browser/scripts/start.jsView on unpkg

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

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

packages/codex-edit/benchmark/run-with-budget.mjsView file

•matchType = normalized_sha256 matchedPackage = @maxiaochao/pi-toolkit@0.11.5 matchedPath = packages/codex-edit/benchmark/run-with-budget.mjs matchedIdentity = npm:QG1heGlhb2NoYW8vcGktdG9vbGtpdA:0.11.5 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/codex-edit/benchmark/run-with-budget.mjsView on unpkg

packages/codex-edit/benchmark/select-tasks.mjsView file

•matchType = normalized_sha256 matchedPackage = @maxiaochao/pi-toolkit@0.11.5 matchedPath = packages/codex-edit/benchmark/select-tasks.mjs matchedIdentity = npm:QG1heGlhb2NoYW8vcGktdG9vbGtpdA:0.11.5 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/codex-edit/benchmark/select-tasks.mjsView on unpkg

packages/codex-edit/tests/generate-test-report.mjsView file

•matchType = normalized_sha256 matchedPackage = @maxiaochao/pi-toolkit@0.11.5 matchedPath = packages/codex-edit/tests/generate-test-report.mjs matchedIdentity = npm:QG1heGlhb2NoYW8vcGktdG9vbGtpdA:0.11.5 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/codex-edit/tests/generate-test-report.mjsView on unpkg

packages/herdr-subagents/extensions/subagent-report.tsView file

•matchType = normalized_sha256 matchedPackage = @maxiaochao/pi-toolkit@0.11.5 matchedPath = packages/herdr-subagents/extensions/subagent-report.ts matchedIdentity = npm:QG1heGlhb2NoYW8vcGktdG9vbGtpdA:0.11.5 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/herdr-subagents/extensions/subagent-report.tsView on unpkg

•matchType = previous_version_dangerous_delta matchedPackage = @maxiaochao/pi-toolkit@0.11.7 matchedIdentity = npm:QG1heGlhb2NoYW8vcGktdG9vbGtpdA:0.11.7 similarity = 0.846 summary = stored previous version shares package body but lacks this dangerous source file

High

Previous Version Dangerous Delta

This package version adds a dangerous source file absent from the previous stored version; route for source-aware review.

packages/herdr-subagents/extensions/subagent-report.tsView on unpkg

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

•matchType = normalized_sha256 matchedPackage = @maxiaochao/pi-toolkit@0.11.5 matchedPath = packages/herdr-subagents/src/herdr.ts matchedIdentity = npm:QG1heGlhb2NoYW8vcGktdG9vbGtpdA:0.11.5 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/herdr-subagents/src/herdr.tsView on unpkg

Source & flagged code

15 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/worktree/tests/extension.test.mjsView file

57L58: const extension = (await import(`${extensionUrl}?test=${Math.random()}`)).default; L59: extension(pi);

Medium

Dynamic Require

Package source references dynamic require/import behavior.

packages/worktree/tests/extension.test.mjsView on unpkg · L57

scripts/install-agents.mjsView file

Findings

1 Critical11 High6 Medium5 Low

CriticalAi Agent Control Hijackscripts/install-agents.mjs

HighInstall Time Lifecycle Scriptspackage.json

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/web-browser/scripts/start.js

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

HighKnown Malware Source Similaritypackages/codex-edit/benchmark/run-with-budget.mjs

HighKnown Malware Source Similaritypackages/codex-edit/benchmark/select-tasks.mjs

HighKnown Malware Source Similaritypackages/codex-edit/tests/generate-test-report.mjs

Affected versions and remediation

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

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

Review the evidence and your use of @maxiaochao/pi-toolkit@0.11.3 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-13 20:15:01.928Z (UTC).

Think this verdict is wrong? Dispute it on GitHub or read how reports are produced.