registry / ruddr / 0.4.7

ruddr@0.4.7

Thin control plane for Codex, Claude Code, OpenCode, and Pi agent sessions: run, steer, observe, and a live TUI with diffs.

AI Security Review

scanned 1d ago · by lpm-firewall-ai

LPM treats this as warn-only first-party agent extension lifecycle risk. The npm postinstall installs Ruddr's bundled agent skill into default user skill directories. This is an automatic first-party extension setup; inspected source does not establish broader control-surface mutation or a confirmed attack.

Static reason

One or more suspicious static signals were detected.; source matched previously finalized malicious package; routed for review; previous stored version diff introduced dangerous source

Trigger

Installing the npm package with lifecycle scripts enabled.

Impact

The skill becomes available to those coding agents without a separate setup command.

Mechanism

The postinstall runs the binary's skill installer, which writes the embedded skill under default Claude and shared agent skill directories, and Codex's directory when present.

AI rationale

The postinstall automatically installs the package's own skill into coding-agent skill directories, creating an agent extension lifecycle risk. The source supports a warning, but does not establish a concrete malicious chain.

Evidence

package.jsonscripts/npm-postinstall.cjsskill.goscripts/npm-binary.cjs~/.claude/skills/ruddr-delegate/SKILL.md~/.agents/skills/ruddr-delegate/SKILL.md~/.codex/skills/ruddr-delegate/SKILL.md

Network endpoints1

github.com/safzanpirani/ruddr/releases/download/v${manifest.version}/${asset}

Decision evidence

public snapshot

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

Evidence for warning

The npm postinstall hook automatically runs the package's postinstall script.
That script invokes the bundled binary's skill installer without requiring a separate user command.
With no directory override, the installer targets Claude and shared agent skill directories, and Codex's directory when present.
The installer writes the package's embedded Ruddr delegate skill into those directories.

Evidence against

The binary download is checked against a pinned SHA-256 checksum before installation.
The observed agent-directory writes install this package's named skill; inspected source does not establish broader agent configuration changes or a malicious payload.

Behavioral surface

Source

ChildProcessCryptoDynamicRequireEnvironmentVarsFilesystemNetwork

Supply chain

HighEntropyStringsUrlStrings

ManifestNo manifest risk signals triggered.

scanned 25 file(s), 352 KB of source, external domains: bun.sh, github.com

Source & flagged code

9 flagged

package.jsonView file

Lines 1-24json

2 "name": "ruddr",

3 "version": "0.4.7",

4 "description": "Thin control plane for Codex, Claude Code, OpenCode, and Pi agent sessions: run, steer, observe, and a live TUI with diffs.",

5 "license": "MIT",

6 "type": "module",

7 "bin": {

8 "ruddr": "bin/ruddr.cjs",

9 "rudder": "bin/ruddr.cjs"

10 },

11 "files": [

12 "bin/",

13 "scripts/npm-binary.cjs",

14 "scripts/npm-postinstall.cjs",

15 "tui/",

16 "adapter/",

17 "claude/",

18 "opencode/",

High

Unverified Remote Native Payload Install

Install-time source downloads a native archive from a fixed external host without transport verification, extracts it, and installs an executable payload.

package.jsonView on unpkg · L4

19 "pi/",

20 "skills/",

21 "*.go",

22 "go.mod",

23 "go.sum",

24 "checksums.json",

Lines 38-69json

38 ],

39 "repository": {

40 "type": "git",

41 "url": "git+https://github.com/safzanpirani/ruddr.git"

42 },

43 "homepage": "https://github.com/safzanpirani/ruddr#readme",

44 "bugs": {

bin/ruddr.cjsView file

Lines 1-25javascript

1#!/usr/bin/env node

2// npm launcher: runs the native Ruddr binary that lives beside the TUI and

3// adapter sources in this package, so the binary's sibling lookup finds them.

4"use strict";

6const { spawnSync } = require("node:child_process");

7const { ensureBinary }

tui/core.ts#virtual:normalized:round1View 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.

tui/core.ts#virtual:normalized:round1View on unpkg

scripts/npm-postinstall.cjsView file

•matchType = normalized_sha256 matchedPackage = ruddr@0.3.3 matchedPath = scripts/npm[redacted] matchedIdentity = npm:cnVkZHI:0.3.3 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.

scripts/npm-postinstall.cjsView on unpkg

tui/core.tsView file

•matchType = normalized_sha256 matchedPackage = ruddr@0.4.0 matchedPath = tui/core.ts matchedIdentity = npm:cnVkZHI: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.

tui/core.tsView on unpkg

pi/runtime.tsView file

•matchType = normalized_sha256 matchedPackage = ruddr@0.4.0 matchedPath = pi/runtime.ts matchedIdentity = npm:cnVkZHI: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.

pi/runtime.tsView on unpkg

tui/git.tsView file

•matchType = normalized_sha256 matchedPackage = ruddr@0.4.0 matchedPath = tui/git.ts matchedIdentity = npm:cnVkZHI: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.

tui/git.tsView on unpkg

scripts/npm-binary.cjsView file

•matchType = previous_version_dangerous_delta matchedPackage = ruddr@0.3.4 matchedIdentity = npm:cnVkZHI:0.3.4 similarity = 0.545 summary = stored previous version shares package body but lacks this dangerous source file

High

Previous Version Dangerous Delta

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

scripts/npm-binary.cjsView on unpkg

Source & flagged code

9 flagged · loading source

package.jsonView file

•scripts.postinstall = node scripts/npm[redacted]

High

Install Time Lifecycle Scripts

Package defines install-time lifecycle scripts.

package.jsonView on unpkg

4scripts.postinstall = node scripts/npm[redacted] Install-time code downloads an unverified remote native executable, stages it locally, activates an executable path, and exposes it to process execution. L4: L5: const { spawnSync } = require("node:child_process"); L6: const { ensureBinary } = require("./npm-binary.cjs"); ... L12: log(`ruddr: installed binary at ${binary}`); L13: const skill = spawnSync(binary, ["skill", "install"], { stdio: ["ignore", "pipe", "pipe"] }); L14: if (skill.error || skill.status !== 0) ... L16: else log(`ruddr: ${String(skill.stdout).trim().split("\n").join("\nruddr: ")}`); L17: const bun = spawnSync("bun", ["--version"], { stdio: "ignore" }); L18: if (bun.error || bun.status !== 0) L19: log("ruddr: Bun 1.4 or newer is required for `ruddr tui` and the Claude, O

High

Unverified Remote Native Payload Install

Install-time source downloads a native archive from a fixed external host without transport verification, extracts it, and installs an executable payload.

package.jsonView on unpkg · L4

bin/ruddr.cjsView file

5L6: const { spawnSync } = require("node:child_process"); L7: const { ensureBinary } = require("../scripts/npm-binary.cjs");

Medium

Dynamic Require

Package source references dynamic require/import behavior.

bin/ruddr.cjsView on unpkg · L5

tui/core.ts#virtual:normalized:round1View 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.

tui/core.ts#virtual:normalized:round1View on unpkg

scripts/npm-postinstall.cjsView file

High

Known Malware Source Similarity

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

scripts/npm-postinstall.cjsView on unpkg

tui/core.tsView file

High

Known Malware Source Similarity

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

tui/core.tsView on unpkg

pi/runtime.tsView file

High

Known Malware Source Similarity

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

pi/runtime.tsView on unpkg

tui/git.tsView file

High

Known Malware Source Similarity

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

tui/git.tsView on unpkg

scripts/npm-binary.cjsView file

High

Previous Version Dangerous Delta

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

scripts/npm-binary.cjsView on unpkg

Findings

8 High4 Medium4 Low

HighInstall Time Lifecycle Scriptspackage.json

HighUnverified Remote Native Payload Installpackage.json

HighSemantic Analysis Limitedtui/core.ts#virtual:normalized:round1

HighKnown Malware Source Similarityscripts/npm-postinstall.cjs

HighKnown Malware Source Similaritytui/core.ts

HighKnown Malware Source Similaritypi/runtime.ts

HighKnown Malware Source Similaritytui/git.ts

HighPrevious Version Dangerous Deltascripts/npm-binary.cjs

MediumDynamic Requirebin/ruddr.cjs

MediumNetwork

MediumEnvironment Vars

MediumStructural Risk Force Deep Review

LowScripts Present

LowFilesystem

LowHigh Entropy Strings

LowUrl Strings

Affected versions and remediation

This report applies to ruddr@0.4.7.

See version security history for other recorded verdicts.

Review the evidence and your use of ruddr@0.4.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-07 21:19:49.972Z (UTC).