registry / AI-agent control-surface risk / kbglow
kbglow
Your Mac's keyboard backlight blinks while your AI agent (e.g. Claude Code) is waiting for approval
This report shows the evidence for kbglow@0.8.0. 6 of 6 known versions are blocked or flagged. See all versions.
AI Security Review
scanned 2mo ago · by lpm-firewall-aiThe observable purpose is a keyboard notification utility, but its npm postinstall automatically injects executable hooks across third-party AI-agent configurations. That meets the firewall block boundary despite no observed network or credential theft. Product guard normalized a concrete AI-agent control hijack publish_block to the blockable dangerous-capability shape.
Static reason
High-risk behavior combination matched malicious policy.
Trigger
npm postinstall when supported agent configuration directories exist
Impact
Future agent events execute the package-owned binary through configured shell hooks.
Mechanism
automatic cross-vendor AI-agent hook and plugin injection
Policy narrative
Installing the package runs setup without an explicit setup command. The setup detects several unrelated AI CLI configuration directories and writes or refreshes hooks/plugins that execute the bundled binary during agent events. This is an unconsented postinstall mutation of foreign, cross-vendor AI-agent control surfaces.
AI rationale
The observable purpose is a keyboard notification utility, but its npm postinstall automatically injects executable hooks across third-party AI-agent configurations. That meets the firewall block boundary despite no observed network or credential theft. Product guard normalized a concrete AI-agent control hijack publish_block to the blockable dangerous-capability shape.
Evidence
package.jsonscripts/setup.jsbin/kbglow~/.claude/settings.json~/.gemini/settings.json~/.qwen/settings.json~/.config/opencode/plugins/kbglow.js
Decision evidence
public snapshotAI identified this as a dangerous AI-agent capability at 95.0% confidence with low false-positive risk.
Evidence for policy risk
- npm postinstall invokes setup automatically.
- Setup writes executable hooks into detected third-party AI CLI configurations.
- It generates an opencode plugin that executes shell commands on agent events.
Evidence against
- No network endpoint or credential-harvesting code found.
- The injected commands only invoke the bundled backlight binary.
- LaunchAgent persistence requires explicit --watch.
Behavioral surface
ChildProcessFilesystemShell
HighEntropyStringsUrlStrings
Source & flagged code
6 flagged · loading sourcepackage.jsonView file
•scripts.postinstall = node scripts/setup.js --postinstall
High
Install Time Lifecycle Scripts
Package defines install-time lifecycle scripts.
package.jsonView on unpkg•scripts.postinstall = node scripts/setup.js --postinstall
Medium
Ambiguous Install Lifecycle Script
Install-time lifecycle script is not statically allowlisted and needs review.
package.jsonView on unpkgscripts/setup.jsView file
1#!/usr/bin/env node
L2: // Wire kbglow into Claude Code's hooks (~/.claude/settings.json) so the
L3: // keyboard blinks while Claude is waiting for approval.
...
L32:
L33: const settingsDir = path.join(os.homedir(), '.claude');
L34: const settingsPath = path.join(settingsDir, 'settings.json');
...
L114: : fs.readFileSync(settingsPath, 'utf8');
L115: fs.writeFileSync(settingsPath + '.kbglow-bak', content);
L116: backedUp = true;
...
L177: function writeJSON(file, obj) {
L178: fs.mkdirSync(path.dirname(file), { recursive: true });
L179: fs.writeFileSync(file, JSON.stringify(obj, null, 2) + '\n');
Findings
1 Critical2 High4 Medium5 Low
CriticalAi Agent Control Hijackscripts/setup.js
HighInstall Time Lifecycle Scriptspackage.json
HighTrigger Reachable Persistencescripts/setup.js
MediumAmbiguous Install Lifecycle Scriptpackage.json
MediumInstall Persistencescripts/setup.js
MediumShips Native Binarybin/kbglow
MediumStructural Risk Force Deep Review
LowNon Install Lifecycle Scripts
LowScripts Present
LowFilesystem
LowHigh Entropy Strings
LowUrl Strings
Affected versions and remediation
This report applies to kbglow@0.8.0.
The versions list below shows the verdict for each recorded version.
- Avoid installing kbglow@0.8.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: .
Think this verdict is wrong? Dispute it on GitHub or read how reports are produced.
Versions
6 known versions0.8.0latestshownMaliciousSoft block: AI-agent control surfaceBlockPublishedAug 14, 2026, 1:05 PM0.4.0MaliciousSoft block: AI-agent control surfaceBlockPublishedAug 11, 2026, 3:26 PM0.3.1MaliciousSoft block: AI-agent control surfaceBlockPublishedAug 11, 2026, 2:56 PM0.3.0MaliciousSoft block: AI-agent control surfaceBlockPublishedAug 11, 2026, 2:46 PM