koalaman/shellcheck

ShellCheck, a static analysis tool for shell scripts

View on GitHub ↗Jump to charts ↓Open shareable report →

koalaman/shellcheck has 40k+ stars and 1.5k+ forks on GitHub, is written in Haskell, and was last pushed on Oct 18, 2026. Data as of . Signed-in members get hourly updates — create a free account.

Summary Information

Updated 14 minutes ago
Added to GitGenius on March 4th, 2026
Created on November 17th, 2012
Open Issues & Pull Requests: 1,086 (+0)
GitHub issues: Enabled
Number of forks: 1,962
Total Stargazers: 40,186 (+0)
Total Subscribers: 409 (+0)

Repository Insights (GitGenius)

Median issue/PR response: 16.5 days
Mean response time: 538.3 days
90th percentile: 2001.9 days
Tracked items: 624

Maintainer activity

1 person did triage or write work on this repository in the last 12 months.

Counts unlabeled, assigned, unassigned, milestoned, demilestoned, locked, unlocked over the last 12 months. These are issue and pull request events that require triage or write permission. Commits and code review are not counted. labeled and renamed are excluded because GitHub issue forms record the issue author as the actor. Figures from October 18, 2026. This count is not comparable across projects: each project's automation decides which of these events a person emits. How this is counted.

How this project is maintained

Roughly one issue in three opened in the past year never receives a reply. 98% of open issues come from outside the core team, so the backlog reflects real-world use rather than internal planning. 73% of tracked open issues have had no activity in three months, so the open count overstates what is actively being worked. Only 45% of issues opened in the past year have been closed. Three people close 88% of everything that gets resolved.

Charts & Analytics

Fetching additional details & charts...

Issue Activity (beta)

Open issues: 373
New in 7 days: 2
Closed in 7 days: 9
Avg open age: 858 days
Stale 30+ days: 350
Stale 90+ days: 321

Recent activity

Opened in 7 days: 2
Closed in 7 days: 9
Comments in 7 days: 11
Events in 7 days: 23

Top labels

  • autofix (1)
  • fix later (1)
  • wontfix (1)
  • working as intended (1)

Most active issues this week

Sign in to see which issues are moving.
Sign in

Detailed Description

ShellCheck is a powerful and versatile static analysis tool designed to meticulously examine shell scripts for potential errors, stylistic issues, and other areas of improvement. Its primary purpose is to enhance the quality, reliability, and security of shell scripts by identifying problems before they manifest during runtime. By automating the process of code review, ShellCheck helps developers write cleaner, more robust, and more maintainable scripts, ultimately saving time and effort in debugging and troubleshooting. It acts as a vigilant "lint" tool, scrutinizing the code for common pitfalls and offering suggestions for best practices.

The core functionality of ShellCheck revolves around its ability to parse and analyze shell script code. It supports a wide range of shell dialects, including Bash, Dash, and others, making it a valuable tool for developers working across different environments. The tool's analysis engine is sophisticated, capable of detecting a vast array of issues. These include syntax errors, such as missing semicolons or unbalanced parentheses; semantic errors, such as incorrect variable usage or undefined variables; and stylistic issues, such as inconsistent indentation or overly complex code structures. Furthermore, ShellCheck can identify potential security vulnerabilities, such as command injection flaws or insecure use of `eval`.

One of the key features of ShellCheck is its ability to provide clear and concise diagnostic messages. When an issue is detected, ShellCheck provides a detailed explanation of the problem, along with suggestions for how to fix it. These messages are often accompanied by examples and links to relevant documentation, making it easy for developers to understand the issue and implement the recommended changes. This user-friendly approach is crucial for promoting code quality and encouraging developers to adopt best practices. The tool's output is designed to be easily integrated into various development workflows, including text editors, IDEs, and continuous integration systems.

ShellCheck's utility extends beyond simply identifying errors. It also serves as an educational tool, helping developers learn about the nuances of shell scripting and improve their coding skills. By highlighting common mistakes and suggesting better alternatives, ShellCheck encourages developers to write more efficient, readable, and secure scripts. This is particularly beneficial for developers who are new to shell scripting or who are working on large and complex projects. The tool's focus on best practices helps to promote consistency and maintainability across a codebase.

In essence, ShellCheck is an indispensable tool for anyone who writes shell scripts. Its ability to automatically detect and diagnose a wide range of issues makes it an invaluable asset for improving code quality, reducing errors, and enhancing security. By integrating ShellCheck into their development workflow, developers can significantly improve the reliability and maintainability of their shell scripts, leading to more efficient and robust software development practices. Its ease of use, comprehensive analysis capabilities, and clear diagnostic messages make it a must-have tool for both novice and experienced shell script developers.