Registry / devops / tree-sitter-cli

tree-sitter-cli

library0.26.8jsnpmunverified

CLI tool for generating and testing Tree-sitter parsers, version 0.26.8. Released as part of the tree-sitter project, which provides a fast incremental parser framework. The CLI supports generating parser C code from grammar files, testing parsers, and building WASM modules. Key differentiators include high performance, incremental parsing with error recovery, and support for multiple languages via grammar definitions. Release cadence is frequent with minor bug fixes and improvements.

devops

npm install tree-sitter-cli

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · TREE-SITTER-CLI

tree-sitter-cli

devopsjavascriptv0.26.8

Install

—

Import

—

Disk

—

Pass rate

0/ 6

Env Coverage0 / 6

glibc

18–22

musl

18–22

Install & Compatibility

Where this runs

tested against v? · npm install

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

node 18–226 runs

build_error

glibc

node 18–226 runs

build_error

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

tree-sitter

✓ import Parser from 'web-tree-sitter'

✗ const Parser = require('tree-sitter')

Use 'web-tree-sitter' for browser/Node ESM; 'tree-sitter' is the C library

Language

✓ import { Language } from 'web-tree-sitter'

✗ import Language from 'tree-sitter'

Language class is named export in web-tree-sitter

Parser

✓ import Parser from 'tree-sitter'

✗ const treeSitter = require('tree-sitter')

Default import for C++ Node addon; ESM not available

generate

✓ npx tree-sitter generate

CLI command, not importable

Parse JavaScript source code using tree-sitter and print the syntax tree.

const Parser = require('tree-sitter'); const JavaScript = require('tree-sitter-javascript'); const parser = new Parser(); parser.setLanguage(JavaScript); const sourceCode = 'let x = 1;'; const tree = parser.parse(sourceCode); console.log(tree.rootNode.toString()); // (program (lexical_declaration (variable_declarator (identifier) (number))))

tree-sitter --version

Debug

Known issues

breakingtree-sitter 0.20+ changed the grammar format; old grammars may not work

fix

Update grammar files to new format (see migration guide)

affects: >=0.20

gotcharequire('tree-sitter') returns the native addon, not the web binding

fix

Use 'web-tree-sitter' for browser or Node ESM

affects: all

deprecatedtree-sitter 0.25 deprecated the --no-ranges flag

fix

Use --ranges or remove flag

affects: >=0.25

Errors

Common errors & fixes

Error: Cannot find module 'tree-sitter'

Native module not installed or incompatible

fix

npm install tree-sitter

TypeError: Parser is not a constructor

Using default import as named import

fix

Use: const Parser = require('tree-sitter');

Error: Language not loaded

WASM or native language file missing

fix

Ensure language module is correctly loaded (e.g., require('tree-sitter-javascript'))

Upgrade

Version history

0.26.8latest on npm

Audit

Dependencies

nodeoptionalRequired for running the CLI

Agent activity

6 hits · last 30 days

node

Resources

githubhttps://github.com/tree-sitter/tree-sitter ↗

packagehttps://www.npmjs.com/package/tree-sitter-cli ↗

homepagehttps://tree-sitter.github.io/tree-sitter/ ↗