# quarylabs/sqruff

Fast SQL formatter/linter

Repository: https://github.com/quarylabs/sqruff
Canonical: https://ross.abutalabs.com/products/sqruff
Homepage: https://playground.quary.dev/docs
Language: Rust
License: Apache-2.0
License Family: permissive
Topics: ansi, bigquery, clickhouse, linter, rust, snowflake, sql
Last push: 2026-08-26T15:14:29+00:00

## Health v2 (maintenance only)
Score: 93/100 (v2, computed 2026-09-03T02:39:23.370411+00:00)
- activity 99, release rhythm 86, longevity 92
- inputs: {"age_days": 1297, "days_push": 7, "days_rel": 19, "gap_med": 2.0, "n_releases_24m": 89}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1377, forks 73 (observed 2026-08-28T04:04:33.347633+00:00)

## What it is
sqruff is a fast SQL linter and formatter written in Rust, inspired by SQLFluff and ruff, supporting many SQL dialects like Postgres, BigQuery, Snowflake, and ClickHouse. It ships as a CLI with lint and fix commands, an LSP server for editor integrations, a GitHub Action, and experimental dbt and column-level lineage support.

## Use cases
- lint sql files in a project
- auto-format sql queries
- replace sqlfluff with a faster tool
- enforce sql style rules in ci
- lint dbt models
- sql linting in vscode or zed

## When to choose
- you need very fast SQL linting/formatting over large codebases
- you want a drop-in-ish SQLFluff replacement with similar config
- you need multi-dialect support (BigQuery, Snowflake, Postgres, ClickHouse, etc.)
- you want editor integration via LSP or a GitHub Action for CI

## When to avoid
- you need to fix partially invalid SQL - sqruff targets valid dialect SQL only
- you rely on exact SQLFluff config compatibility long-term, as configs may diverge
- you need dbt support without the Python install, or stable column-level lineage (both experimental)

## Facets
- artifact type: cli-tool
- maturity: active
- function: linter, formatter, cli, developer-tools
- domain: developer-tools, databases
- platform: cli, windows, editor-plugin, rust, python
- tags: sql, sqlfluff-alternative, lsp, dbt, bigquery, snowflake, postgres, code-quality, ci, data-engineering, command-line, macos, linux, docker

## Member repositories
- quarylabs/sqruff (main) score 93

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:33.347633+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-30T04:40:27.237379+00:00, confidence not recorded.
  - readme: https://github.com/quarylabs/sqruff (fetched 2026-08-28T04:04:33.347633+00:00, sha 76f57e8fbf19)
  - homepage: https://playground.quary.dev/docs (fetched 2026-08-29T11:56:43.583140+00:00, sha 9eab7e987bc5)
  - site_page: https://playground.quary.dev/docs/usage/lint (fetched 2026-08-29T11:56:43.594799+00:00, sha 835e37974f71)
  - site_page: https://playground.quary.dev/docs/getting-started/installation (fetched 2026-08-29T11:56:43.592693+00:00, sha bc7a86c93399)
  - site_page: https://playground.quary.dev/docs/usage/configuration (fetched 2026-08-29T11:56:43.596757+00:00, sha ec852dcb58cc)
  - site_page: https://playground.quary.dev/docs/usage/editors (fetched 2026-08-29T11:56:43.598551+00:00, sha 66ee47fd6cd8)
  - site_page: https://playground.quary.dev/docs/experimental/dbt (fetched 2026-08-29T11:56:43.600347+00:00, sha 352c4533013e)
  - site_page: https://playground.quary.dev/docs/usage/noqa (fetched 2026-08-29T11:56:43.601995+00:00, sha b645d0cff7d4)
  - site_page: https://playground.quary.dev/docs/usage/ignore-files (fetched 2026-08-29T11:56:43.603550+00:00, sha 47daee421005)
  - site_page: https://playground.quary.dev/docs/reference/dialects (fetched 2026-08-29T11:56:43.605094+00:00, sha 3566cb915dfd)
- Data as of 2026-08-30T08:39:29.467469+00:00.