---
id: tree-sitter-bash
version: "0.25.1"
license: MIT
license_treatment: permissive
maintenance: aging
---

# tree-sitter-bash — Bash grammar for tree-sitter

License: permissive · Maintenance: aging · Popularity: top 1,000 on PyPI

## Install

pip install tree-sitter-bash
uv add tree-sitter-bash
poetry add tree-sitter-bash

## Description

# tree-sitter-bash

[![CI][ci]](https://github.com/tree-sitter/tree-sitter-bash/actions/workflows/ci.yml)
[![discord][discord]](https://discord.gg/w7nTvsVJhm)
[![matrix][matrix]](https://matrix.to/#/#tree-sitter-chat:matrix.org)
[![crates][crates]](https://crates.io/crates/tree-sitter-bash)
[![npm][npm]](https://www.npmjs.com/package/tree-sitter-bash)
[![pypi][pypi]](https://pypi.org/project/tree-sitter-bash)

Bash grammar for [tree-sitter](https://github.com/tree-sitter/tree-sitter).

## Development

Install the dependencies:

```sh
npm install
```

Build and run the tests:

```sh
npm run build
npm run test
```

Run the build and tests in watch mode:

```sh
npm run test:watch
```

### References

- [Bash man page](http://man7.org/linux/man-pages/man1/bash.1.html#SHELL_GRAMMAR)
- [Shell command language specification](http://pubs.opengroup.org/onlinepubs/9699919799/utilities/V3_chap02.html)
- [mvdnan/sh - a shell parser in go](https://github.com/mvdan/sh)

[ci]: https://img.shields.io/github/actions/workflow/status/tree-sitter/tree-sitter-bash/ci.yml?logo=github&label=CI
[discord]: https://img.shields.io/discord/1063097320771698699?logo=discord&label=discord
[matrix]:...

## AI interpretation — verify before relying

Provides a tree-sitter grammar for parsing Bash shell scripts, enabling incremental syntax analysis and AST generation for Bash code.

Verdict: A permissively licensed Bash grammar binding with good platform coverage via precompiled wheels and no known vulnerabilities. However, the aging maintenance status (254 days since last release) and lack of explicit runtime dependencies in the metadata warrant verification of actual usage requirements before installation.

[View on SkillFed](https://skillfed.io/packages/tree-sitter-bash) · [View on PyPI](https://pypi.org/project/tree-sitter-bash/)