🛡️ BLA (Blind LLM Agents) — Adversarial defense shield that protects binaries, Electron apps, JS bundles, Python, and WebAssembly against AI reverse-engineering agents like REA. Poison -> Exhaust -> Hallucinate.
Installation & Setup Guide
BLA (bla-agents — Blind LLM Agents) is distributed as a zero-config Node.js CLI and MCP server that runs anywhere Node.js ^22.23.4 || >=24.0.0 is installed (matches package.json engines).
1. Quick Start (npx)
Run BLA directly without installing anything globally:
# 1. Register BLA MCP Server + Skill into Claude Code, Cursor, Codex, Windsurf, Gemini CLI, etc.
npx bla-agents setup
# 2. Check your environment and configured AI clients
npx bla-agents doctor
# 3. Audit an artifact for REA exposure before release
npx bla-agents audit ./dist/app.js
# 4. Protect the artifact with BLA's three-stage shield
npx bla-agents protect ./dist/app.js --mode bankrupt
# 5. Verify functional preservation and REA analyzer degradation
npx bla-agents verify ./dist/app.js ./dist/app.bla.js
2. Global or Project-Local Installation
Install as a Dev Dependency (Recommended for CI/CD Release Pipelines)
npm install --save-dev bla-agents
# or
pnpm add -D bla-agents
# or
bun add -d bla-agents
Then add a post-build protection script to your package.json:
{
"scripts": {
"build": "vite build",
"postbuild": "bla protect ./dist/assets/index.js --in-place --mode bankrupt --emit-sourcemap"
}
}
Install Globally
npm install -g bla-agents
# Both `bla` and `bla-agents` binaries are registered:
bla --version
bla-agents doctor
3. Registering BLA in Coding Agents (bla setup)
Just like npx reverse-engineer-anything setup, npx bla-agents setup auto-discovers installed AI coding agents on your machine and registers:
- The
blaMCP stdio server (bla_audit,bla_protect,bla_verify,bla_benchmark,bla_emit_headers,bla_doctor) - The
blind-llm-agentsskill (SKILL.md+ Counter-REA Matrix)
Supported Clients
| Client ID | Name | Config Location | Skill Location |
|---|---|---|---|
claude-code |
Claude Code | ~/.claude.json |
~/.claude/skills/blind-llm-agents |
cursor |
Cursor | ~/.cursor/mcp.json |
~/.cursor/skills/blind-llm-agents |
codex |
OpenAI Codex | ~/.codex/config.toml |
~/.codex/skills/blind-llm-agents |
windsurf |
Windsurf | ~/.codeium/windsurf/mcp_config.json |
~/.codeium/windsurf/skills/blind-llm-agents |
gemini |
Gemini CLI | ~/.gemini/settings.json |
~/.gemini/skills/blind-llm-agents |
opencode |
OpenCode | ~/.config/opencode/opencode.json |
~/.config/opencode/skills/blind-llm-agents |
Target Specific Clients
npx bla-agents setup --client claude-code,cursor
Uninstall
To cleanly remove BLA from all agent configuration files and delete installed skill folders:
npx bla-agents uninstall
4. Compile-Time Header Integration (C / C++ / Rust / Go)
If you are shipping a native binary compiled with clang, gcc, rustc, or go build, you can embed BLA's compile-time counters directly into .rodata before linking:
npx bla-agents emit-headers ./include/shield --seed my-release-v1
- C / C++:
#include "bla_shield.h"and callBLA_ANCHOR_SHIELD();insidemain(). - Rust:
mod bla_shield;and callbla_shield::anchor_shield();insidefn main(). - Go: Include
bla_shield.goin your package and callAnchorBlaShield()insidefunc main().