Loading npm security reports…

@hanzlaa/rcode@4.17.0: AI-agent control-surface risk | LPM Firewall

registry / @hanzlaa/rcode / 4.17.0

@hanzlaa/rcode@4.17.0

rcode — the AI team that never forgets. Persistent memory, specialist agents, and slash commands for AI IDEs. Works in Claude Code, Cursor, Gemini, VS Code, and Antigravity.

AI Security Review

scanned 27d ago · by lpm-firewall-ai

LPM flags this version as an AI-agent control-surface risk. A global npm install automatically populates the user's global Claude Code configuration with package-supplied agents, commands, skills, and tooling. This changes the AI-agent control surface without an interactive consent step.

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

npm global installation runs the postinstall lifecycle hook.

Impact

Future Claude Code sessions can load and expose package-controlled commands, agents, and skills globally.

Mechanism

postinstall launches a non-interactive global installer that writes Claude Code extensions.

Policy narrative

Installing this package globally runs postinstall, which invokes its bundled CLI with --global, --yes, and --no-prompt. The installer targets the home directory, automatically selects Claude Code, and copies package content into global Claude agent and command locations. That creates a persistent, package-controlled AI-agent extension surface without a separate user command or consent prompt.

AI rationale

The automatic lifecycle chain writes into a broad global AI-agent control surface. Its scoped filenames and lack of confirmed exfiltration reduce the apparent payload severity, but they do not remove the unconsented install-time control-surface mutation.

Evidence

package.jsoncli/postinstall.jscli/install.jscli/lib/install-ide.cjscli/lib/install-plan.cjs~/.claude/agents/~/.claude/commands/~/.claude/skills/

Source & flagged code

25 flagged · loading source

package.jsonView file

•devDependencies registry_only=@clack/prompts,diff,esbuild,fast-glob,nanospinner,picocolors,semver,zod

Critical

Manifest Confusion

Tarball package.json differs from the npm registry version manifest for scripts or dependency sets.

package.jsonView on unpkg

•scripts.postinstall = node cli/postinstall.js

High

Install Time Lifecycle Scripts

Package defines install-time lifecycle scripts.

package.jsonView on unpkg

•scripts.postinstall = node cli/postinstall.js

Medium

Ambiguous Install Lifecycle Script

Install-time lifecycle script is not statically allowlisted and needs review.

package.jsonView on unpkg

dist/rcode.jsView file

216`)){let s=n.replace(/#.*$/,"");if(!s.trim())continue;let i=s.match(/^(\s*)/)[1].length;if(i===0){let o=s.indexOf(":");if(o===-1)continue;let a=s.slice(0,o).trim(),c=s.slice(o+1).tr... L217: `)}Qg.exports={readPackageManifest:Qo,verifyInstall:p1,verifyClaudeInstall:Kg,verifyRulesInstall:vu,verifyAntigravityInstall:Xg,formatReport:m1}});var sD=y((uP,nD)=>{var rt=require... L218: `)+`

High

Child Process

Package source references child process execution.

dist/rcode.jsView on unpkg · L216

3var y=(t,e)=>()=>(e||t((e={exports:{}}).exports,e),e.exports);var ht=y((iR,al)=>{var yv=require("crypto"),ft=require("fs"),Sn=require("path");function il(t,e,r={}){let{encoding:n="... L4: `;il(t,n,r)}function _v(t,e){let r;try{r=ft.lstatSync(t)}catch(o){return o.code==="ENOENT"?{ok:!0,reason:"missing"}:{ok:!1,reason:`lstat: ${o.message}`}}if(r.isSymbolicLink())try{r... L5: `).reduce((r,n)=>r+=Math.max(1,Math.ceil(n.length/e)),0)}function jv(t="",e={}){let r=0,n=e.interval||50,s=e.stream||process.stderr,i=e.frames&&e.frames.length?e.frames:Ut.symbols.... L6: `,p.write(S,!0),Ut.isTTY&&(c=Fv(S,s.columns)),p},spin(){return p.render(),r=++r%i.length,p},update(S){return typeof S=="string"?t=S:(t=S.text||t,i=S.frames&&S.frames.length?S.frame... L7: `}`:"",!0),Ut.isTTY&&!x?p.write("\x1B[?25h")

High

Sandbox Evasion Gated Capability

Source gates dangerous network, credential, or execution behavior behind CI, host, platform, time, or geo fingerprint checks.

dist/rcode.jsView on unpkg · L3

•matchType = normalized_sha256 matchedPackage = @hanzlaa/rcode@4.14.0 matchedPath = dist/rcode.js matchedIdentity = npm:QGhhbnpsYWEvcmNvZGU:4.14.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.

dist/rcode.jsView on unpkg

2/* rcode — built with esbuild. Source: github.com/hanzlahabib/rihal-code */ L3: var y=(t,e)=>()=>(e||t((e={exports:{}}).exports,e),e.exports);var ht=y((iR,al)=>{var yv=require("crypto"),ft=require("fs"),Sn=require("path");function il(t,e,r={}){let{encoding:n="... L4: `;il(t,n,r)}function _v(t,e){let r;try{r=ft.lstatSync(t)}catch(o){return o.code==="ENOENT"?{ok:!0,reason:"missing"}:{ok:!1,reason:`lstat: ${o.message}`}}if(r.isSymbolicLink())try{r...

Medium

Dynamic Require

Package source references dynamic require/import behavior.

dist/rcode.jsView on unpkg · L2

rcode/bin/lib/memory-digest.cjsView file

1'use strict'; L2: /**

Low

Weak Crypto

Package source references weak cryptographic algorithms.

rcode/bin/lib/memory-digest.cjsView on unpkg · L1

cli/postinstall.jsView file

4* Auto-installs commands, skills, workflows, and bin tools into the global L5: * Claude Code directory (~/.claude/) so every project can use rcode immediately L6: * without needing a per-project `rcode install` run. ... L61: // #924 — opt-out for users who install the package globally but do NOT want L62: // their ~/.claude mutated (e.g. inspecting the package, or managing the global L63: // install themselves). Setting RCODE_NO_POSTINSTALL=1 (or the npm-config ... L80: L81: const globalTarget = path.join(os.homedir(), '.claude'); L82: ... L109: }; L110: fs.mkdirSync(globalTarget, { recursive: true }); L111: fs.writeFileSync(receiptPath, JSON.stringify(receipt, null, 2) + '\n');

Critical

Ai Agent Control Hijack

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

cli/postinstall.jsView on unpkg · L4

32Cross-file remote execution chain: cli/postinstall.js spawns dist/rcode.js; helper contains network access plus dynamic code execution. L32: * Pure function — takes its inputs explicitly so tests can drive every L33: * branch without needing to mutate process.env / __dirname / process.cwd. L34: * ... L67: if (require.main === module) { L68: if (process.env.CI || process.env.NODE_ENV === 'test') { L69: process.exit(0); ... L71: if (process.env.RCODE_NO_POSTINSTALL === '1' || process.env.npm[redacted]) { L72: process.stderr.write('\nrcode: skipping global auto-install (RCODE_NO_POSTINSTALL set).\n'); L73: process.stderr.write(" Run 'rcode install --global' when you want /rcode-* commands.\n\n"); ... L86: // devDependencies (picocolors, semver, etc.) are not installed for global package

High

Cross File Remote Execution Context

Source spawns a local helper that also contains network and dynamic execution context; review data flow before blocking.

cli/postinstall.jsView on unpkg · L32

cli/index.jsView file

•Runtime or CLI code links a write operation to an explicit external AI-agent control path: ────────────────────────────────────'); console.log(`▶ to run: paste the above into claude code as /${workflowname === 'execute-sprint' ? 'rcode-execute-sprint' : `rcode-${workflowname}`}`); console.log(' or pipe it directly: rcode ' + (workflowname === 'execute-sprint' ? 'execute' : workflowname) + ' | cld --model sonnet'); if (hasauto) { console.log('\n auto mode detected — in claude code run: /rcode-' + (workflowname === 'execute-sprint' ? 'execute-sprint' : workflowname) + ' --auto (applies yolo defaults, skips confirmation prompts)'); } }

High

External Ai Agent Control Surface Mutation

Runtime or CLI source writes behavior-bearing configuration into a user or project AI-agent control surface.

cli/index.jsView on unpkg

•matchType = token_shingles matchedPackage = @hanzlaa/rcode@4.14.0 matchedPath = cli/index.js matchedIdentity = npm:QGhhbnpsYWEvcmNvZGU:4.14.0 similarity = 1.000 shingleOverlap = 48 summary = source token shingles overlapped finalized malicious source

High

Known Malware Source Similarity

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

cli/index.jsView on unpkg

cli/uninstall.jsView file

•Manifest-trigger-reachable source links an external AI-agent control path to a behavior-bearing write operation. n(cwd, '.claude/commands')).length === 0) { fs.rmdirsync(path.join(cwd, '.claude/commands')); } if (fs.existssync(agentsdir) && fs.readdirsync(agentsdir).length === 0) { fs.rmdirsync(agentsdir); } } catch { } } if (editors.includes('cursor')) { const cursordir = path.join(cwd, '.cursor/rules'); const n = removematching(cursordir, (name) => name.startswith('rcode-') || name === 'rcode.mdc' || name === 'rcode-method.mdc' || name === 'rcode', ); removed += n; if (n > 0) console.log(` ✓ removed ${n} cursor rules`); } if (editors.includes('windsurf')) { const windsurfdir = path.join(cwd,

High

Trigger Reachable External Ai Agent Control Surface Mutation

Manifest-trigger-reachable source writes behavior-bearing configuration into a user or project AI-agent control surface.

cli/uninstall.jsView on unpkg

rcode/skills/core/rcode-distillator/scripts/tests/test_analyze_sources.pyView file

•path = rcode/skills/core/rcode-distillator/scripts/tests/test_analyze_sources.py kind = payload_in_excluded_dir sizeBytes = 7723 magicHex = [redacted]

High

Payload In Excluded Dir

Package hides binary, compressed, or executable-looking payloads in test/fixture/hidden paths.

rcode/skills/core/rcode-distillator/scripts/tests/test_analyze_sources.pyView on unpkg

•path = rcode/skills/core/rcode-distillator/scripts/tests/test_analyze_sources.py kind = build_helper sizeBytes = 7723 magicHex = [redacted]

Medium

Ships Build Helper

Package ships non-JavaScript build or shell helper files.

rcode/skills/core/rcode-distillator/scripts/tests/test_analyze_sources.pyView on unpkg

cli/doctor.js#virtual:normalized:round1View file

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

High

Semantic Analysis Limited

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

cli/doctor.js#virtual:normalized:round1View on unpkg

cli/agent.jsView file

•matchType = normalized_sha256 matchedPackage = @hanzlaa/rcode@4.14.0 matchedPath = cli/agent.js matchedIdentity = npm:QGhhbnpsYWEvcmNvZGU:4.14.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.

cli/agent.jsView on unpkg

rcode/bin/lib/memory-drift.cjsView file

•matchType = normalized_sha256 matchedPackage = @hanzlaa/rcode@4.14.0 matchedPath = rcode/bin/lib/memory-drift.cjs matchedIdentity = npm:QGhhbnpsYWEvcmNvZGU:4.14.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.

rcode/bin/lib/memory-drift.cjsView on unpkg

rcode/bin/lib/progress.cjsView file

•matchType = normalized_sha256 matchedPackage = @hanzlaa/rcode@4.14.0 matchedPath = rcode/bin/lib/progress.cjs matchedIdentity = npm:QGhhbnpsYWEvcmNvZGU:4.14.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.

rcode/bin/lib/progress.cjsView on unpkg

rcode/bin/rcode-hooks.cjsView file

•matchType = normalized_sha256 matchedPackage = @hanzlaa/rcode@4.14.0 matchedPath = rcode/bin/rcode-hooks.cjs matchedIdentity = npm:QGhhbnpsYWEvcmNvZGU:4.14.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.

rcode/bin/rcode-hooks.cjsView on unpkg

rcode/bin/rcode-tools.cjsView file

•matchType = normalized_sha256 matchedPackage = @hanzlaa/rcode@4.14.0 matchedPath = rcode/bin/rcode-tools.cjs matchedIdentity = npm:QGhhbnpsYWEvcmNvZGU:4.14.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.

rcode/bin/rcode-tools.cjsView on unpkg

cli/dashboard.jsView file

•matchType = normalized_sha256 matchedPackage = @hanzlaa/rcode@4.14.0 matchedPath = cli/dashboard.js matchedIdentity = npm:QGhhbnpsYWEvcmNvZGU:4.14.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.

cli/dashboard.jsView on unpkg

cli/github-sync.jsView file

•matchType = normalized_sha256 matchedPackage = @hanzlaa/rcode@4.14.0 matchedPath = cli/github-sync.js matchedIdentity = npm:QGhhbnpsYWEvcmNvZGU:4.14.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.

cli/github-sync.jsView on unpkg

server/orchestrator.jsView file

•matchType = previous_version_dangerous_delta matchedPackage = @hanzlaa/rcode@4.15.2 matchedIdentity = npm:QGhhbnpsYWEvcmNvZGU:4.15.2 similarity = 0.746 summary = stored previous version shares package body but lacks this dangerous source file

Critical

Previous Version Dangerous Delta

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

server/orchestrator.jsView on unpkg

Lines 196-236javascript

196`;return Ft(t,i+a+n),{action:"appended"}}catch(i){return{action:"skipped-error",error:i.message}}}function u1(t,e){let r={},n=new Set(e||[]),s=i=>[`## ${i}`,"","This project has [rcode](https://www.npmjs.com/package/@hanzlaa/rcode) installed \u2014","persistent project memory, specialist agents, and structured workflows under `.rcode/`.","","For any non-trivial task (new feature, bug fix that needs investigation, multi-file","change, planning) prefer routing through **`/rcode-do <task description>`** \u2014 rcode's","command picker \u2014 instead of working ad hoc. It picks the right rcode com ...

197`);if(n.has("claude")||n.has("vscode")){let i="",o="",a=`${i}

198

199${s("Working with rcode")}

200

201${o}

202`;r.claude=yu(tt.join(t,"CLAUDE.md"),i,o,a)}if(n.has("codex")){let i="",o="",a=`${i}

203

204${s("Working with rcode")}

205

206${o}

207`;r.codex=yu(tt.join(t,"AGENTS.md"),i,o,a)}if(n.has("cursor")){let i=["---","description: Prefer rcode's /rcode-do command for non-trivial work","alwaysApply: true","---","",s("Working with rcode"),""

208`);try{let o=tt.join(t,".cursor","rules","rcode-prefer-do.mdc");Ne.mkdirSync(tt.dirname(o),{recursive:!0}),Ft(o,i),r.cursor={action:"written"}}catch(o){r.cursor={action:"skipped-error",error:o.message}}}

209`);try{let o=tt.join(t,".windsurf","rules","rcode-prefer-do.mdc");Ne.mkdirSync(tt.dirname(o),{recursive:!0}),Ft(o,i),r.windsurf={action:"written"}}catch(o){r.windsurf={action:"skipped-error",error:o.message}}}

210`),o=tt.join(r,"hooks"),a=tt.join(o,"pre-commit");try{let l=function(d,f){let m=d.indexOf(n);if(m<0)return null;let h=d.indexOf(s,m);if(h<0){let v=m;return v>0&&d[v-1]===`

211`&&(v-=1),d.slice(0,v)+f}let D=m;D>0&&d[D-1]===`

212`&&(D-=1);let p=h+s.length;return d[p]===`

213`&&(p+=1),d.slice(0,D)+f+d.slice(p)};var c=l;if(Ne.mkdirSync(o,{recursive:!0}),!Ne.existsSync(a))return Ft(a,`#!/bin/sh

214${i}`,{mode:493}),{action:"created"};let u=Ne.readFileSync(a,"utf8");if(u.includes(n)){let d=l(u,i);return d!==null&&d!==u?(Ft(a,d,{mode:493}),{action:"updated"}):{action:"already-present"}}return Ft(a,u+i,{mode:493}),{action:"appended"}}catch(u){return{action:"skipped-error",error:u.message}}}Ug.exports={resolveCommitPlanning:o1,resolveEnableHooks:i1,ensureRcodeSettingsHooks:a1,ensureRcodeGitignore:c1,spliceMarkedBlockIntoFile:yu,ensureRcodePreferredCommandRule:u1,ensureRcodePreCommitHook:l1}});var Yg=y((aP,zg)=>{var{z:Le}=So(),Gg=Le.object({user_name:Le.string().min(1),project_name:Le.string ...

215`)}function f1(t){let e=Gg.safeParse(t);return e.success?{valid:!0}:{valid:!1,errors:e.error.issues.map(n=>` ${n.path.

216`)){let s=n.replace(/#.*$/,"");if(!s.trim())continue;let i=s.match(/^(\s*)/)[1].length;if(i===0){let o=

217`)}Qg.exports={readPackageManifest:Qo,verifyInstall:p1,verifyClaudeInstall:Kg,verifyRulesInstall:vu,verifyAntigravityInstall:Xg,formatReport:m1}});var sD=y((uP,nD)=>{var rt=require("fs"),vt=require("path"),g1=qr(),{homedir:eD}=pt(),{ok:D1,fail:tD,dim:_u,bold:y1,PACKAGE_ROOT:rD}=dn();function v1(t,e){let{spawnSync:r}=require("child_process"),n=[];for(let u of e){let l=u.rel||u.dest;if(!l)continue;let d=vt.join(t,l);rt.existsSync(d)&&n.push(l)}for(let u of[".rcode/config.yaml",".rcode/state.json",".rcode/_config/manifest.yaml",".rcode/_config/files-manifest.csv"])rt.existsSync(vt.join(t,u))&&n.p ...

218`)+`

High

Child Process

Package source references child process execution.

dist/rcode.jsView on unpkg · L216

219`,encoding:"utf8"});return c.status!==0?{ok:!1,warning:`tar failed: ${(c.stderr||"").trim().split(`

220`)[0]}`,fileCount:n.length}:{ok:!0,path:a,fileCount:n.length}}function _1(t){let e=vt.join(t,"package.json"),r=vt.join(t,"pnpm-lock.yaml");

221`),console.log(" "+ei(`${n}: wired slash-router into ${e} hook (existing hooks preserved).`)),!0)}function aD(t){let e=Ds(),r=Re.join(e,".codex","skills");Mn(r);let n=Re.join(iD,"skills");if(!Tr.existsSync(n))return 0;let s=0;for(let i of oD(n)){if(Re.basename(i)!=="SKILL.md")continue;let o=Re.dirname(i),a=Re.basename(o),c=a.startsWith("rcode-")?a:`rcode-${a}`,u=Re.join(r,c);Mn(u);for(let l of oD(o)){let d=Re.relative(o,l),f=Re.join(u,d);Mn(Re.dirname(f)),Tr.copyFileSync(l,f)}s++}return t&&t.global!=="silent"&&console.log(" "+ei(`Codex skills: ${s} \u2192 ~/.codex/skills/rcode-*/`)),s}functi ...

222`))}function vD(){console.log(`

223rcode installer

224

225Usage:

226 node cli/install.js [target-dir]

227

228Options:

229 --force overwrite existing files without prompting

230 --reset with --force, also delete config.yaml and state.json to re-init

231 --yes non-interactive, accept defaults

232 --user <name> set user_name in config.yaml (default: $USER)

233 --project <name> set project_name (default: basename of target-dir)

234 --language <lang> set communication_language (default: English)

235 --mode <guided|yolo> default mode (default: guided)

236 --ide <name> target IDE (claude, cursor, gemini; default: claude)

Long lines were clipped for display.