Security disclosure documentation for claude-flow npm package supply chain vulnerabilities
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
2026-01-24 13:42:59 -05:00
.gitignore Initial security disclosure documentation for claude-flow npm package 2026-01-24 16:03:41 +00:00
2026-01-24-httpsmaatissecurity-disclosurehtml.txt Initial security disclosure documentation for claude-flow npm package 2026-01-24 16:03:41 +00:00
EVIDENCE.md Initial security disclosure documentation for claude-flow npm package 2026-01-24 16:03:41 +00:00
IMPACT-SCENARIOS.md Add catastrophic impact scenarios documentation 2026-01-24 16:10:53 +00:00
README.md Add Deep Dive link to README 2026-01-24 13:42:59 -05:00
SECURITY-REPORT.md Initial security disclosure documentation for claude-flow npm package 2026-01-24 16:03:41 +00:00
TIMELINE.md Initial security disclosure documentation for claude-flow npm package 2026-01-24 16:03:41 +00:00

claude-flow Security Disclosure

This repository documents critical security vulnerabilities discovered in the claude-flow npm package.

Disclosure Date: 2026-01-24 Package: claude-flow Claimed Downloads: ~500,000 Severity: Critical

Summary

The claude-flow npm package contains multiple supply chain attack vulnerabilities that enable:

  • Remote injection of behavioral patterns into Claude instances
  • Access to complete conversation histories via session file reading
  • Fake cryptographic verification (checks string length, not actual signatures)
  • Silent execution of arbitrary code on every Claude operation

Vulnerabilities

ID Vulnerability Severity Location
CF-001 Fake Ed25519 signature verification Critical registry.ts:285, discovery.ts:402, download.ts:314
CF-002 Hardcoded trusted IPNS bootstrap keys High registry.ts:24-41
CF-003 Fabricated CIDs on network failure High discovery.ts:228-237
CF-004 Hardcoded fallback payload High discovery.ts:318-389
CF-005 Claude session file access High claude-telemetry.js:16-20
CF-006 Silent automatic hook execution High .claude/settings.json
CF-007 OpenTelemetry exfiltration vector Medium claude-telemetry.js:93-98

Immediate Actions

  1. Remove claude-flow from all projects
  2. Audit any .claude/settings.json files for suspicious hooks
  3. Check if session data was accessed
  4. Block IPFS gateway domains if not explicitly needed

Quick Removal Commands

# Terminate running processes
pkill -f claude-flow

# Remove config entries
# Edit ~/.claude/settings.json and remove claude-flow hooks

# Delete artifacts
rm -rf ~/.claude-flow

Full Remediation Guide: https://maat.is/report.html

Documentation

Academic Publication

This vulnerability has been formally documented in a peer-archived research paper:

Cognitive Supply Chain Compromise: An Exhaustive Forensic Analysis of the claude-flow and agentic-flow Behavioral Injection Vulnerabilities

Files:

Reporting

License

This security research is provided for defensive purposes under responsible disclosure principles.