Ruff vs ShellCheck: open-source code quality and static analysis tools compared
Metrics as of , from the GitHub or GitLab API of each repository. Refreshed monthly.
Summary
Ruff: Python linter and code formatter written in Rust that covers Flake8, Black and isort functions in one tool.
ShellCheck: Static analysis tool that flags syntax, semantic and portability problems in bash and sh scripts.
Both are listed under Code quality and static analysis. The table gives repository metrics from the GitHub API with their fetch date, then the documented facts used for every comparison in this category, each linked to the README or docs page it comes from. A cell reads "not documented" when the fact was not found in the project's documentation; that does not mean the feature is absent.
Side by side
| Fact | Ruff | ShellCheck |
|---|---|---|
| Stars | 49,7311 | 40,0671 |
| Forks | 2,4301 | 1,9461 |
| Contributors | 9791 | 1791 |
| Last release | 2026-09-161 | 2025-08-041 |
| Last commit | 2026-09-221 | 2026-09-211 |
| Commits in 90 days | 1,4471 | 91 |
| License | MIT1 | GPL-3.01 |
| Primary language | Rust1 | Haskell1 |
| Status | active1 | active1 |
| Languages or files analysed | Python files (*.py, *.pyi), Jupyter Notebooks (*.ipynb) and pyproject.toml source: Docs: Configuring Ruff | Shell scripts in the sh, bash, dash, ksh and BusyBox dialects source: Docs: shellcheck(1) manual |
| Configuration format | TOML settings in pyproject.toml, ruff.toml or .ruff.toml source: README | key=value directives in .shellcheckrc files and in script comments source: Docs: shellcheck(1) manual |
| CI integration | GitHub Actions (ruff-action) and a GitLab CI/CD example with a code quality report source: Docs: Integrations | Pre-installed on Travis CI, CircleCI (ShellCheck Orb), GitHub (Linux), Codacy, Code Climate and other services source: README |
| Report formats | concise, full, JSON, JSON Lines, JUnit, grouped, GitHub, GitLab, Pylint, rdjson, Azure, SARIF source: Docs: Configuring Ruff | JSON, CheckStyle XML, GCC-compatible warnings, plain text source: README |
| Install method | PyPI package ruff via uv, pip or pipx; standalone installers source: README | OS package managers (apt, pacman, dnf, brew, choco, winget and others); Docker image koalaman/shellcheck; binaries source: README |
1 Fetched from the GitHub or GitLab API on . Hover a value for its own date.
When each fits
Written from each project's documented scope, not from preference. Neither tool is ranked.
Ruff
Fits projects that lint and format Python code with one tool; its README describes use in place of Flake8, Black, isort, pydocstyle, pyupgrade and autoflake. source: README
ShellCheck
Fits projects that contain bash or sh shell scripts; its README describes a static analysis tool that warns about syntax issues, semantic problems and pitfalls in those scripts. source: README
More on these tools
Sources
- GitHub REST API: repository, read
- GitHub REST API: repository, read
- GitHub REST API: contributors, read
- GitHub REST API: contributors, read
- GitHub REST API: latest release, read
- GitHub REST API: latest release, read
- GitHub REST API: commits, read
- GitHub REST API: commits, read
- Docs: Configuring Ruff, read
- Docs: shellcheck(1) manual, read
- README, read
- Docs: Integrations, read
- README, read
Documented facts collected 2026-09-22. See the methodology for how metrics and facts are gathered.