supabase-community/postgres-language-server

README

A collection of language tools and a Language Server Protocol (LSP) implementation for Postgres, focusing on developer experience and reliable SQL tooling.

Documentation | Installation | CLI Releases

VSCode | Cursor | Neovim | Zed | Sublime Text

Overview

LSP Demo	CLI Demo

This project provides a toolchain for Postgres development, built on Postgres' own parser libpg_query to ensure 100% syntax compatibility. It is built on a Server-Client architecture with a transport-agnostic design. All features can be accessed through the Language Server Protocol, a CLI, HTTP APIs, and a WebAssembly module. The goal is to make all the great Postgres tooling out there as accessible as possible, and to build anything that is missing ourselves.

The following features are available today:

Development

nix develop     # or skip if not using Nix
docker-compose up -d

See CONTRIBUTING.md for the development workflow and ARCHITECTURE.md for an overview of the code base.

Acknowledgements

A big thanks to the following projects, without which this project wouldn't have been possible:

libpg_query: For extracting the Postgres' parser
Biome: For implementing a toolchain infrastructure we could copy from
Squawk: For the linter inspiration