# bash-lsp/bash-language-server

A language server for Bash

Repository: https://github.com/bash-lsp/bash-language-server
Canonical: https://ross.abutalabs.com/products/bash-language-server
Language: TypeScript
License: MIT
License Family: permissive
Topics: language-server, bash
Last push: 2026-08-26T19:57:13+00:00

## Health v2 (maintenance only)
Score: 74/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 99, release rhythm 28, longevity 100
- inputs: {"age_days": 3112, "days_push": 7, "days_rel": 507, "gap_med": 50.0, "n_releases_24m": 3}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2774, forks 153 (observed 2026-08-28T04:07:19.140684+00:00)

## What it is
A Language Server Protocol implementation for Bash that provides IDE-like features such as completion, jump to declaration, diagnostics, and formatting for shell scripts. It integrates with shellcheck for linting and shfmt for formatting, and works with most editors via LSP clients.

## Use cases
- add bash autocompletion and hover docs to my editor
- lint shell scripts with shellcheck inside my IDE
- jump to declaration and find references in bash scripts
- format bash scripts consistently with shfmt
- set up bash language server for neovim or helix
- get diagnostics and code outline for shell scripts

## When to choose
- you write or maintain bash/shell scripts and want IDE features
- you use an editor with LSP support like Neovim, VS Code, Emacs, or Helix
- you want integrated shellcheck linting and shfmt formatting

## When to avoid
- you need a full bash debugger or execution environment
- you work primarily with other shells like zsh or fish with shell-specific features
- you need scope-accurate reference analysis, which is still on the roadmap

## Facets
- artifact type: library
- maturity: active
- function: editor, linter, formatter, developer-tools
- domain: developer-tools, text-editors
- platform: cli, cross-platform
- tags: language-server, lsp, bash, shell-scripting, tree-sitter, shellcheck, shfmt, command-line, nodejs

## Member repositories
- bash-lsp/bash-language-server (main) score 74

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:07:19.140684+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T08:16:34.871024+00:00, confidence not recorded.
  - readme: https://github.com/bash-lsp/bash-language-server (fetched 2026-08-28T04:07:19.140684+00:00, sha 249f29d1f6ff)
  - registry_npm: https://registry.npmjs.org/bash-language-server (fetched 2026-08-29T09:56:01.402912+00:00, sha 5f284e8618c0)
- Data as of 2026-08-30T08:39:29.467469+00:00.