unstale

npm / @ast-grep/cli

@ast-grep/cli

What changed in @ast-grep/cli 0.45 to 0.51, from its official release notes, upgrade guides and advisories. Also covers @ast-grep/napi. Sources checked 2026-11-11.

6 breaking2 security10 new APIs and options1 behavior and defaults2 tooling12 fixes and other

See which of these apply to your code, ranked, in your agent:

npx @unstale/cli init

@unstale/cli on npm

@ast-grep/cli 0.5117 changes

Breaking changes 4

  • The command fails when IDs are unmatched or when no tests run.

    0.51.2release notes

  • The convert transform no longer splits words at digits.

    0.51.2release notes

  • LSP columns are reported in UTF-16 code units.

    0.51.2release notes

  • Unknown top-level keys in rule config are rejected.

    0.51.1release notes

Security 1

  • A memory corruption issue with web-tree-sitter 0.26 is fixed.

    0.51.1release notes

New APIs and options 1

Behavior and default changes 1

  • The inspect entity output now reports skipped files and the reason each file was skipped.

    0.51.1release notes

Tooling 2

  • CLI binaries are now distributed for musl Linux.

    0.51.2release notes

  • The project setup hint now uses the ast-grep name.

    0.51.0release notes

Fixes and other changes 8

  • A dollar sign followed by a digit remains literal in fix templates.

    0.51.1release notes

  • Special characters in GitHub format output are escaped.

    0.51.1release notes

  • Matching for macOS universal2 wheels is fixed.

    0.51.1release notes

  • Only metavariable sigils are replaced with the expando character.

    0.51.1release notes

  • Utility directories are bound for rules supplied through --inline-rules and --rules.

    0.51.1release notes

  • The SARIF log version is set to 2.1.0.

    0.51.1release notes

  • File paths in SARIF URIs are percent-encoded.

    0.51.1release notes

  • Files are preserved when update-all writes fail.

    0.51.0release notes

@ast-grep/cli 0.5011 changes

Breaking changes 2

  • Custom language loading now uses a policy, and custom language libraries require opt-in.

    0.50.0release notes

  • Schema validation now rejects null relation fields.

    0.50.0release notes

Security 1

  • The CLI can trust and revoke custom language policies.

    0.50.0release notes

New APIs and options 6

  • Java outline rules were added for annotation types and elements.

    0.50.0release notes

  • An outline rule was added for Java enum members.

    0.50.0release notes

  • An outline rule was added for Java module declarations.

    0.50.0release notes

  • An outline rule was added for Java record declarations.

    0.50.0release notes

  • Outline rules were added for Java wildcard imports.

    0.50.0release notes

  • Zig support was added.

    0.50.0release notes

Fixes and other changes 2

  • C/C++ declarator identifier names are now captured.

    0.50.0release notes

  • Java private and protected fields are now reported in the outline.

    0.50.0release notes

@ast-grep/cli 0.455 changes

New APIs and options 3

Fixes and other changes 2

  • Fixes the ordering requirement for ast-grep-ignore to take effect.

    0.45.3release notes

  • Anchors fallback signatures to names.

    0.45.3release notes