registry / @maxiaochao/pi-toolkit / 0.2.2
@maxiaochao/pi-toolkit@0.2.2
Personal pi coding agent toolkit: /todos, /btw, /cache_export extensions, browser automation, and bundled theme/skills.
AI Security Review
scanned 11d ago · by lpm-firewall-aiThe automatic postinstall write can change Pi agent instructions, so a warning is appropriate under the agent extension lifecycle policy. The inspected behavior supports a guarded capability warning, not a confirmed malicious attack.
Static reason
High-risk behavior combination matched malicious policy.
Trigger
The package's postinstall hook runs during installation.
Impact
This can change instructions used by the user's Pi agent without a separate setup command.
Mechanism
The setup script writes the bundled AGENTS.md when the existing file is missing or differs.
AI rationale
The automatic postinstall write can change Pi agent instructions, so a warning is appropriate under the agent extension lifecycle policy. The inspected behavior supports a guarded capability warning, not a confirmed malicious attack.
Evidence
package.jsonscripts/install-agents.mjsglobal/AGENTS.md~/.pi/agent/AGENTS.md
Decision evidence
public snapshotAI called this Suspicious at 83.0% confidence as Dangerous Capability with medium false-positive risk.
Evidence for warning
- The postinstall hook automatically runs the agent setup script during installation.
- The script targets the user's Pi agent directory and loads this package's bundled instructions.
- When the existing agent instructions differ, the script replaces them with the bundled file.
Evidence against
- The write is limited to Pi's agent directory and uses instructions bundled with this package.
- The script does not send data over the network or launch a remote payload.
Behavioral surface
ChildProcessEnvironmentVarsFilesystemNetworkShellWebSocket
HighEntropyStringsUrlStrings
NoLicense
Source & flagged code
4 flagged · loading sourcepackage.jsonView file
•scripts.postinstall = node scripts/install-agents.mjs
High
Install Time Lifecycle Scripts
Package defines install-time lifecycle scripts.
package.jsonView on unpkg50"postinstall": "node scripts/install-agents.mjs"
},
"publishConfig": {
"access": "public"
}
}
Medium
Suspicious Lifecycle Evidence
The postinstall hook automatically runs the agent setup script during installation.
package.jsonView on unpkg · L50scripts/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";
...
L8: const agentDir = join(homedir(), ".pi", "agent");
L9: const bundled = readFileSync(join(dirname(fileURLToPath(import.meta.url)), "..", "global", "AGENTS.md"), "utf8");
L10: const agentsTarget = join(agentDir, "AGENTS.md");
L11: const settingsTarget = join(agentDir, "settings.json");
...
L13: if (!existsSync(agentsTarget) || readFileSync(agentsTarget, "utf8") !== bundled) {
L14: mkdirSync(dirname(agentsTarget), { recursive: true });
L15: writeFileSync(agentsTarget, bundled, "utf8");
L16: console.log("[pi-toolkit] gl
Findings
1 Critical1 High5 Medium5 Low
CriticalAi Agent Control Hijackscripts/install-agents.mjs
HighInstall Time Lifecycle Scriptspackage.json
MediumNetwork
MediumEnvironment Vars
MediumStructural Risk Force Deep Review
MediumSuspicious Lifecycle Evidencepackage.json
MediumAi Review Evidencescripts/install-agents.mjs
LowScripts Present
LowFilesystem
LowHigh Entropy Strings
LowUrl Strings
LowNo License
Affected versions and remediation
This report applies to @maxiaochao/pi-toolkit@0.2.2.
See all versions of @maxiaochao/pi-toolkit for other recorded verdicts.
- Review the evidence and your use of @maxiaochao/pi-toolkit@0.2.2 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: .
Think this verdict is wrong? Dispute it on GitHub or read how reports are produced.