registry / @maxiaochao/pi-toolkit / 0.5.0

@maxiaochao/pi-toolkit@0.5.0

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

AI Security Review

scanned 28d ago · by lpm-firewall-ai

npm installation mutates the user's global Pi agent control surface without an explicit setup command. It overwrites global agent instructions and also places a user-wide executable.

Static reason

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

Trigger

Installing the package runs its postinstall lifecycle hook.

Impact

The package can replace instructions used by the user's Pi agent and persist a command in the user's home directory.

Mechanism

Postinstall writes global Pi configuration and copies user-wide files.

Attack narrative

On installation, npm invokes scripts/install-agents.mjs. The hook compares the existing global .pi/agent/AGENTS.md with its bundled content and overwrites it whenever it differs, rather than obtaining consent or limiting changes to this package's own directory. It also initializes global Pi settings and copies a command into .local. This is unconsented install-time mutation of a broad AI-agent control surface.

AI rationale

The postinstall hook automatically overwrites global Pi agent instructions and creates user-wide files. This meets the install-hook abuse policy even though no network exfiltration was found.

Evidence

package.jsonscripts/install-agents.mjs.pi/agent/AGENTS.md.pi/agent/settings.json.local/bin/pi-worktree.local/share/bash-completion/completions/pi-worktree

Decision evidence

public snapshot

AI called this Malicious at 98.0% confidence as Malware with low false-positive risk.

Evidence for block

The package automatically runs an installer after npm installation.
That installer overwrites the user's global Pi agent instructions when they differ and creates or changes global agent settings.
The same automatic hook copies an executable and shell completion into user-wide locations.

Evidence against

The automatic installer contains no network request or secret-harvesting code.
There is no runtime dependency on another release of this package.

Behavioral surface

Source

ChildProcessEnvironmentVarsFilesystemNetworkShellWebSocket

Supply chain

HighEntropyStringsUrlStrings

Manifest

NoLicense

scanned 24 file(s), 232 KB of source, external domains: 127.0.0.1, example.com

Source & flagged code

10 flagged

package.jsonView file

Lines 34-60json

34 "./themes"

35 ]

36 },

37 "bin": {

38 "pi-worktree": "bin/pi-worktree"

39 },

40 "peerDependencies": {

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

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

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

44 "typebox": "*"

45 },

46 "dependencies": {

47 "ws": "^8.19.0"

48 },

49 "scripts": {

50 "test": "cd extensions/cache-export && node --experimental-strip-types tests/run-tests.mjs && node --experimental-strip-types ../tests/btw-history.mjs && node tests/e2e-browser.mjs",

51 "load-test": "pi -ne -e ./extensions/todo.ts && pi -ne -e ./extensions/cache-export/index.ts && pi -ne -e ./extensions/btw.ts",

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

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

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

High

Install Time Lifecycle Scripts

Package defines install-time lifecycle scripts.

package.jsonView on unpkg · L54

55 },

56 "publishConfig": {

57 "access": "public"

58 }

59}

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

Lines 1-32javascript

1// Real-browser end-to-end test for the cache dashboard.

2// Drives actual pointer events in headless Chromium via raw CDP (Node 22

3// built-ins only: fetch + WebSocket) and asserts the hover tooltip keeps

4// working across polyline break boundaries and inside segment views.

5//

6// Chrome discovery mirrors the web-browser skill (BROWSER_BIN, common Linux

7// paths, Playwright cache, WSL Windows Chrome). If no browser is found the

8// test prints SKIP and exits 0 so CI without Chrome still passes; if a

9// browser IS found, failing assertions exit 1.

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, copyFileSync, chmodSync } from "node:fs";

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

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

bin/pi-worktree-completion.bashView file

•path = 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.

bin/pi-worktree-completion.bashView on unpkg

bin/pi-worktreeView file

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

High

Semantic Analysis Limited

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

bin/pi-worktreeView on unpkg

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

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

Source & flagged code

10 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

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

12L13: import { spawn, execFileSync } from "node:child_process"; L14: import { existsSync, mkdtempSync, readdirSync, rmSync } from "node:fs";

High

Child Process

Package source references child process execution.

extensions/cache-export/tests/e2e-browser.mjsView on unpkg · L12

187const userDataDir = usesWindowsChrome L188: ? commandOutput("powershell.exe", ["-NoProfile", "-NonInteractive", "-Command", L189: "[Environment]::GetFolderPath('LocalApplicationData')"]) + `\\agent-web\\e2e-${process.pid}`

High

Shell

Package source references shell execution.

extensions/cache-export/tests/e2e-browser.mjsView on unpkg · L187

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

extensions/cache-export/tests/e2e-browser.mjsView 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.4.0 matchedPath = skills/chrome-cdp/scripts/cdp.mjs matchedIdentity = npm:QG1heGlhb2NoYW8vcGktdG9vbGtpdA:0.4.0 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, copyFileSync, chmodSync } from "node:fs"; L4: import { homedir, platform } from "node:os"; ... L10: const agentDir = join(homedir(), ".pi", "agent"); L11: const bundled = readFileSync(join(dirname(fileURLToPath(import.meta.url)), "..", "global", "AGENTS.md"), "utf8"); L12: const agentsTarget = join(agentDir, "AGENTS.md"); L13: const settingsTarget = join(agentDir, "settings.json"); ... L15: if (!existsSync(agentsTarget) || readFileSync(agentsTarget, "utf8") !== bundled) { L16: mkdirSync(dirname(agentsTarget), { recursive: true }); L17: writeFileSync(agentsTarget, bundled, "utf8

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

bin/pi-worktree-completion.bashView file

•path = 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.

bin/pi-worktree-completion.bashView on unpkg

bin/pi-worktreeView file

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

High

Semantic Analysis Limited

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

bin/pi-worktreeView on unpkg

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

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

Findings

1 Critical8 High4 Medium5 Low

CriticalAi Agent Control Hijackscripts/install-agents.mjs

HighInstall Time Lifecycle Scriptspackage.json

HighChild Processextensions/cache-export/tests/e2e-browser.mjs

HighShellextensions/cache-export/tests/e2e-browser.mjs

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

HighSemantic Analysis Limitedbin/pi-worktree

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

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

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

MediumNetwork

MediumEnvironment Vars

MediumShips Build Helperbin/pi-worktree-completion.bash

MediumStructural Risk Force Deep Review

LowScripts Present

LowFilesystem

LowHigh Entropy Strings

LowUrl Strings

LowNo License

Affected versions and remediation

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

See version security history for other recorded verdicts.

Avoid installing @maxiaochao/pi-toolkit@0.5.0. 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-09-11 06:05:40.885Z (UTC).