tree-sitter-bash
Bash grammar for tree-sitter
Decision gist · record as of 2026-08-14
Yes, if you need to parse or analyze Bash scripts programmatically. The package has no known vulnerabilities, offers permissive MIT licensing, and provides prebuilt wheels for common platforms. The aging maintenance status (255 days since last release) is typical for stable language grammars. Install friction is moderate but manageable.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.10 or later; integration with tree-sitter parsing framework requires separate setup.
- Medium install friction due to compiled wheels; prebuilt binaries available for common platforms (Linux x86_64/aarch64, macOS, Windows).
- Package is aging—last release 255 days ago—but repository remains active with recent commits and no archived status.
License · maintenance · safety
MIT (permissive) — MIT license is permissive; you can use this package freely in commercial and proprietary projects with minimal restrictions.
last release 2025-12-02 (255 days) · last repo commit 2025-12-02 · 325 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 26,104,748 downloads/mo, #890 on PyPI
Alternatives
Verify before relying
pip install tree-sitter-bash
import tree_sitter_bash- Whether the package is actively maintained or in maintenance-only mode given the 255-day gap since last release.
- Performance characteristics for parsing large or complex Bash scripts.
- Completeness of Bash grammar coverage and supported Bash versions.
- How to integrate tree-sitter-bash with the broader tree-sitter ecosystem for actual parsing.
What it is and what it does
tree-sitter-bash is a language grammar for the tree-sitter incremental parser framework, specifically targeting Bash shell scripts. It translates Bash source code into a concrete syntax tree that preserves structural information and can be queried programmatically. The package is a compiled extension distributed as prebuilt wheels for common architectures (Linux, macOS, Windows).
Developers use this package when they need to analyze, transform, or lint Bash scripts programmatically—for example, building linters, refactoring tools, documentation generators, or security scanners that operate on shell code. It requires Python 3.10 or later and integrates with the tree-sitter ecosystem.
Use it for
- Build a Bash linter or style checker that traverses the syntax tree to enforce coding standards.
- Extract function definitions, variable assignments, or command invocations from shell scripts for analysis.
- Implement incremental re-parsing of Bash files during editing to support real-time syntax highlighting.
- Generate documentation or dependency graphs from Bash scripts by querying the parse tree.
- Detect security issues or anti-patterns in shell code by pattern-matching against the syntax tree.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you need to parse or analyze Bash scripts programmatically.
The package has no known vulnerabilities, offers permissive MIT licensing, and provides prebuilt wheels for common platforms. The aging maintenance status (255 days since last release) is typical for stable language grammars. Install friction is moderate but manageable.
Install
tree-sitter-bash on PyPI
Before you install
Medium install friction due to compiled wheels; prebuilt binaries available for common platforms (Linux x86_64/aarch64, macOS, Windows). Package is aging—last release 255 days ago—but repository remains active with recent commits and no archived status.
Requires Python 3.10 or later; integration with tree-sitter parsing framework requires separate setup.
License in practice
MIT license is permissive; you can use this package freely in commercial and proprietary projects with minimal restrictions.
Quickstart
pip install tree-sitter-bash
import tree_sitter_bashVerify before relying
- Whether the package is actively maintained or in maintenance-only mode given the 255-day gap since last release.
- Performance characteristics for parsing large or complex Bash scripts.
- Completeness of Bash grammar coverage and supported Bash versions.
- How to integrate tree-sitter-bash with the broader tree-sitter ecosystem for actual parsing.
Package facts
| License | MIT permissive |
| Python support | Supports the current Python release >=3.10 |
| Install friction | Medium. Platform-specific wheel |
| Runtime dependencies | None |
| Maintenance | Aging 255 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 26,104,748 / month, #890 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Intended Audience :: DevelopersLicense :: OSI Approved :: MIT LicenseTopic :: Software Development :: CompilersTopic :: Text Processing :: LinguisticTyping :: Typed |
Evidence: tree_sitter_bash-0.25.1-cp310-abi3-macosx_10_9_x86_64.whl; tree_sitter_bash-0.25.1-cp310-abi3-macosx_11_0_arm64.whl; tree_sitter_bash-0.25.1-cp310-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl; tree_sitter_bash-0.25.1-cp310-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl; tree_sitter_bash-0.25.1-cp310-abi3-musllinux_1_2_aarch64.whl; tree_sitter_bash-0.25.1-cp310-abi3-musllinux_1_2_x86_64.whl; tree_sitter_bash-0.25.1-cp310-abi3-win_amd64.whl; tree_sitter_bash-0.25.1-cp310-abi3-win_arm64.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “bash parser tree-sitter”
- tree-sitter-bashProvides a tree-sitter grammar for parsing Bash shell scripts into an…
- bashlexbashlex parses bash shell syntax into an abstract syntax tree (AST),…
- tree-sitter-xmlProvides a tree-sitter parser grammar for XML and DTD files, enabling…
Give your agent the search over MCP, or paste the wish link into any chat.
More Linguistic packages
Detects and normalizes text encoding from unknown or ambiguous sources, supporting all IANA character sets that Python's core library provides codecs for, with the ability to register custom codecs.
tiktoken is a fast BPE tokenizer that converts text into token sequences compatible with OpenAI models, supporting multiple encoding schemes including o200k_base and model-specific encodings.
Install it if you work with OpenAI APIs or need to understand token boundaries in GPT-family models.
Detects character encoding and language in byte sequences with high accuracy, supporting 99 encodings and returning confidence scores, language tags, and MIME types.
Install it if you need to detect character encoding or language in byte data; the rewrite makes it substantially faster and more accurate than its predecessors.
Converts Unicode text to ASCII by transliterating non-ASCII characters into their closest ASCII equivalents, with no runtime dependencies.
However, if transliteration quality or ongoing maintenance matters, consider unidecode instead despite its GPL-only license.
Lark is a parsing library that builds abstract syntax trees from context-free grammars, supporting multiple parsing algorithms (Earley, LALR(1), CYK) with automatic line and column tracking.
Python bindings to the tree-sitter parsing library, enabling incremental parsing and syntax tree analysis for source code.
See also tree-sitter-python · tree-sitter-java · tree-sitter-php · tree-sitter-go · tree-sitter-zig · tree-sitter-c · tree-sitter-json · braceexpand · tree-sitter-css · tree-sitter-ruby