registry / recess-cli / 3.17.0
recess-cli@3.17.0
Safe Recess administration and family AI tools from the command line.
AI Security Review
scanned 12d ago · by lpm-firewall-aiThe postinstall hook automatically mutates agent skill directories as part of first-party package setup, which meets the warning criteria for package-owned agent extension lifecycle risk. The inspected scope does not establish a malicious attack or block-eligible behavior.
Static reason
One or more suspicious static signals were detected.
Trigger
npm installation of a published package containing dist/setup.js.
Impact
Agent skill configuration changes without a separate setup command; the inspected behavior does not establish a broader control-surface attack.
Mechanism
The hook calls installSkill(), which removes and copies files into the named recess-cli skill directories and removes the superseded recess-admin directory.
AI rationale
The postinstall hook automatically mutates agent skill directories as part of first-party package setup, which meets the warning criteria for package-owned agent extension lifecycle risk. The inspected scope does not establish a malicious attack or block-eligible behavior.
Evidence
package.jsonscripts/postinstall.mjsdist/setup.js
Decision evidence
public snapshotAI called this Suspicious at 88.0% confidence as Dangerous Capability with medium false-positive risk.
Evidence for warning
- The package runs scripts/postinstall.mjs after installation.
- The hook imports and runs installSkill() in a published install when dist/setup.js exists.
- installSkill() targets the package's own recess-cli skill directories for Codex and Claude, removes and replaces those directories, and also removes the superseded recess-admin skill.
- The apps init command writes AGENTS.md into the user-selected app folder when explicitly invoked.
Evidence against
- The lifecycle hook skips source checkouts, and its filesystem changes are limited to the named Recess skill directories.
- The inspected apps init behavior is command-triggered and writes into the selected app folder.
Behavioral surface
ChildProcessCryptoDynamicRequireEnvironmentVarsFilesystemNetworkShell
HighEntropyStringsUrlStrings
Source & flagged code
4 flagged · loading sourcepackage.jsonView file
•scripts.postinstall = node scripts/postinstall.mjs
High
Install Time Lifecycle Scripts
Package defines install-time lifecycle scripts.
package.jsonView on unpkg•scripts.postinstall = node scripts/postinstall.mjs
Medium
Ambiguous Install Lifecycle Script
Install-time lifecycle script is not statically allowlisted and needs review.
package.jsonView on unpkgdist/commands/onboarding.jsView file
564patternName = generic_password
severity = medium
line = 564
Medium
Secret Pattern
Package contains a possible secret pattern.
dist/commands/onboarding.jsView on unpkg · L564Findings
1 High6 Medium5 Low
HighInstall Time Lifecycle Scriptspackage.json
MediumAmbiguous Install Lifecycle Scriptpackage.json
MediumSecret Patterndist/commands/onboarding.js
MediumDynamic Requirescripts/postinstall.mjs
MediumNetwork
MediumEnvironment Vars
MediumStructural Risk Force Deep Review
LowScripts Present
LowFilesystem
LowHigh Entropy Strings
LowUrl Strings
LowNo License
Affected versions and remediation
This report applies to recess-cli@3.17.0.
See all versions of recess-cli for other recorded verdicts.
- Review the evidence and your use of recess-cli@3.17.0 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.