# qybaihe/bla

> bla is an open-source command-line tool and MCP server that software authors and security teams use to protect their own release artifacts against AI reverse-engineering agents. It audits build outputs such as dist/ folders, .asar archives and .wasm files, then rewrites them with decoy content and analyzer limits that those agents run into. The project is written mainly in TypeScript and distributed through npm.

Source: https://github.com/qybaihe/bla
Indexed: commit 645993f on 2026-11-17 by Repowise. Facts come from the source and git history, not from the maintainer.

## Facts

- Type: Command-line tool
- Language: TypeScript
- Stars: 6,097 at index time
- License: MIT
- Code health: 5.5/10, Needs_work
- Last commit: 2026-11-16
- Contributors: 7

## Install

From the README: https://github.com/qybaihe/bla

Harden a project or release directory from its root.
    npx bla-agents harden .

Register bla with your coding agent.
    npx bla-agents setup

## How it works

Input enters through the bla command in a terminal or through an MCP client, and both routes end in the protection engine. The engine in src/engine audits shipped artifacts such as .wasm and .sqlite files before protection runs, and it can be called with a project directory or a single file. src/mcp/server.ts exposes bla's MCP tools so a coding agent can drive the same engine. The shield code rewrites the files, and src/core supplies shared configuration that names generated output, sets the seed and signs manifests. scripts/redteam/run.mjs checks whether REA's analyzers still read files correctly after bla has shielded them.

- challenge/v6/run.mjs: entry point
- challenge/v7/run.mjs: entry point
- challenge/v8/run.mjs: entry point
- challenge/v9/run.mjs: entry point
- scripts/redteam/run.mjs: entry point
Modules: tests, src, scripts, challenge, examples, website, root. 445 files, 108,988 lines, 4,065 symbols.

## Code health

- Score: 5.5/10 (Needs_work)
- Trend: 5.4 on 2026-11-12, 5.5 on 2026-11-17
- Rank: #233 of 4,000+ indexed repos
- Hotspots: src/shields/runtime/sidecar-entangle.ts, src/mcp/server.ts, src/engine/harden.ts, src/shields/javascript/ast-shield.ts, src/shields/weave/weave-decoy.ts
- Lowest file: src/shields/javascript/ast-shield.ts
- Dead code: 1 findings

## Maintenance

- Last commit 2026-11-16, first commit 2026-10-25, 493 commits
- 7 contributors, bus factor 1

## Security

- Security findings are shown to signed-in users at https://repowise.dev/repo/qybaihe/bla/security

## More

- Page: https://repowise.dev/repo/qybaihe/bla
- Ask this codebase: https://repowise.dev/repo/qybaihe/bla/chat
- Docs: https://repowise.dev/repo/qybaihe/bla/docs
- MCP (signs in with Repowise on first use):
    claude mcp add --transport http repowise https://api.repowise.dev/mcp/qybaihe/bla
