bonsai-lint for VS Code

Flags functions that are hard to read, across PHP, JavaScript and TypeScript. Powered by bonsai-lint — a single Rust binary, with no PHP runtime and no Node runtime involved in the analysis.

What it does

Reports one warning per function that scores above the threshold, on the declaration line. Cognitive complexity measures how hard code is to read, where cyclomatic complexity measures how hard it is to test.

It analyses the buffer as you type, not the file on disk, so a diagnostic appears before you save. Analysis is debounced, and each file is scored in a single short-lived process.

It sees code other tools miss

Procedural scripts, templates, route files and module-level bootstrap are scored too, reported as <toplevel>, rather than skipped for living outside a function.

It agrees with CI, by design

The extension deliberately does not pass a threshold unless you set one. Your repository's bonsai-lint.toml, its per-domain thresholds, its excludes, its baselines and your bonsai-lint-ignore markers all apply exactly as they do on the command line. What you see in the editor is what the build will fail on — nothing more, nothing less.

Anything that goes wrong — a broken bonsai-lint.toml, a binary that will not start — is written to the bonsai-lint output channel, and the first occurrence of each problem pops up once.

Settings

Requirements

VS Code 1.90 or newer. Install the CLI with brew install ryckakas/tap/bonsai-lint, or set bonsai-lint.path to a binary you already have. The extension will tell you once if it cannot find one.

License

MIT