becwright

becwright is a pre-commit code-checking tool that enforces deterministic constraints on AI-generated code before a commit is finalized. It runs checks against actual code to block secrets, debug remnants, and unsafe constructs, aborting the commit if a rule is violated. The tool functions as a verification layer that complements instruction-style files like CLAUDE.md and .cursorrules by ensuring rules are followed in practice rather than just noted.

The tool is distributed as a self-contained binary available via npm, pnpm, and pipx, and it does not require a Python runtime to operate. Users install the engine once, scaffold their rules using becwright init, and then every commit triggers the checks over staged files. If a blocking rule fails, the commit is immediately stopped and aborted.

becwright is designed for developers using AI agents to write code who need a safety net for the 5% of errors that slip through probabilistic guidance. It is particularly useful for teams where notes like CLAUDE.md are ignored or where agents regenerate modules without reading previous instructions. The tool ensures that session tokens and credentials never reach logs by executing a check that returns a pass or fail exit code.

The tool includes specific blocking rules such as no-dangerous-eval, no-debug-remnants, and no-token-in-logs. For example, the no-token-in-logs rule prevents session tokens from leaking into log files, which could allow anyone with access to steal a session. Each rule has an associated intent and a why_it_matters explanation to ensure the constraint is born tied to the original decision.

becwright is an open-source project built by David, who uses the GitHub handle DataDave-Dev. The project operates under an MIT license, and all checks, releases, and design decisions are made public in the repository. Users can submit bug reports, feature requests, and BEC proposals through GitHub issues, which include specific templates for each type of submission.

The tool is positioned as a complement to instruction-style guidance files like CLAUDE.md and .cursorrules, functioning as a verification layer rather than a textual instruction. While CLAUDE.md prevents issues 95% of the time by asking agents to be respected, becwright guarantees the remaining 5% by running a physical bump in the road—a deterministic check against the real code.

becwright is a Bound Executable Constraint (BEC) that carries three properties: it is bound to the intent, executable with a pass/fail result, and portable across repositories. These properties close gaps left by other artifacts, ensuring the rule is not just a loose note but a check that runs and returns a specific exit code of 0 or 1.

The tool can be installed on various ecosystems including npm, pnpm, and pipx, and it ships a self-contained binary that requires no Python runtime. This makes it accessible to developers regardless of their specific package manager preference or environment setup.

The tool provides a deterministic guarantee that a rule was respected, unlike notes which depend on an agent reading and obeying. A note is a probabilistic promise, whereas becwright runs against the real staged code to return a guaranteed pass or fail, no matter which agent or model made the change.

becwright is available as an open-source project under the MIT license, and the fastest channel for communication is through GitHub issues. For other inquiries, the website lists a contact email, but GitHub issues are preferred for bug reports and feature requests.

The tool is free to use as it is open source, and the website mentions a donate option for contributions. There are no stated subscription fees or pricing tiers, making it accessible for individual developers and large organizations alike.

becwright is located in the digital space and serves information technology and services industries globally through its open-source nature. The tool is available for use in any market where npm, pnpm, or pipx are supported, and it does not restrict access by geography.

The official website of becwright is becwright.dev.

On Trustburn, becwright has a rating of 4.2 out of 5 based on 5 reviews.