registry / @maxiaochao/pi-toolkit / 0.10.7

@maxiaochao/pi-toolkit@0.10.7

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

AI Security Review

scanned 14d ago · by lpm-firewall-ai

The postinstall hook mutates a global agent instruction file and installs a CLI without a separate setup command, so this warrants a warning under the first-party agent setup policy. The inspected behavior supports an agent extension lifecycle warning, not a confirmed malicious attack.

Static reason

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

Trigger

Installing the package through npm runs its postinstall hook.

Impact

The bundled instructions can replace the user’s global Pi agent instructions and affect later agent sessions.

Mechanism

The hook copies the bundled AGENTS.md into ~/.pi/agent/AGENTS.md when the existing file differs, and installs pi-worktree and its completion file under the user’s home directory.

AI rationale

Evidence

package.jsonscripts/install-agents.mjspackages/worktree/scripts/install.mjs

Decision evidence

public snapshot

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

Evidence for warning

The npm postinstall hook automatically runs scripts/install-agents.mjs.
The installer targets the global Pi agent directory and replaces its AGENTS.md with the package-bundled file whenever they differ.
The same hook installs a pi-worktree executable and shell completion files under the user’s home directory.

Evidence against

The agent configuration and CLI files come from this Pi toolkit package; inspection found no network transfer or credential handling in this setup path.
The installer only sets a default theme when no theme is already configured.

Behavioral surface

Source

ChildProcessCryptoEnvironmentVarsFilesystemNetworkShellWebSocket

Supply chain

HighEntropyStringsUrlStrings

Manifest

NoLicense

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

Source & flagged code

17 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/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

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

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

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

High

Shell

Package source references shell execution.

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

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

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

12import { resolve } from 'path'; L13: import { spawn } from 'child_process'; L14: import net from 'net'; L15: ... L24: const RUNTIME_DIR = IS_WINDOWS L25: ? resolve(process.env.LOCALAPPDATA || resolve(homedir(), 'AppData', 'Local'), 'cdp') L26: : process.env.XDG_RUNTIME_DIR

High

Same File Env Network Execution

A single source file combines environment access, network access, and code or shell execution; review context before blocking.

skills/chrome-cdp/scripts/cdp.mjsView on unpkg · L12

•matchType = normalized_sha256 matchedPackage = @maxiaochao/pi-toolkit@0.10.5 matchedPath = skills/chrome-cdp/scripts/cdp.mjs matchedIdentity = npm:QG1heGlhb2NoYW8vcGktdG9vbGtpdA:0.10.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/chrome-cdp/scripts/cdp.mjsView on unpkg

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 = 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.10.5 matchedPath = packages/cache-export/tests/e2e-browser.mjs matchedIdentity = npm:QG1heGlhb2NoYW8vcGktdG9vbGtpdA:0.10.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.10.5 matchedPath = packages/codex-edit/benchmark/run-with-budget.mjs matchedIdentity = npm:QG1heGlhb2NoYW8vcGktdG9vbGtpdA:0.10.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.10.5 matchedPath = packages/codex-edit/benchmark/select-tasks.mjs matchedIdentity = npm:QG1heGlhb2NoYW8vcGktdG9vbGtpdA:0.10.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.10.5 matchedPath = packages/codex-edit/tests/generate-test-report.mjs matchedIdentity = npm:QG1heGlhb2NoYW8vcGktdG9vbGtpdA:0.10.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.10.5 matchedPath = packages/herdr-subagents/extensions/subagent-report.ts matchedIdentity = npm:QG1heGlhb2NoYW8vcGktdG9vbGtpdA:0.10.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

Source & flagged code

17 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

High

Known Malware Source Similarity

Source file is highly similar to a previously finalized malicious package; route for source-aware review.

Findings

1 Critical14 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.7.

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

Review the evidence and your use of @maxiaochao/pi-toolkit@0.10.7 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-09 08:20:04.327Z (UTC).

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