Our take
Inactiveno commits in over a year- Activity
- 19
- Community
- 74
- Issues
- 21
- Pull requests
- 20
+47 stars in the last 30 days
- More contributors than 78% of the projects we track
The Fuck remains a capable, highly configurable shell helper, but its inactive development makes it harder to recommend for teams that need ongoing maintenance.
Good fit if
- You want an interactive correction aid for everyday shell mistakes, and can review suggestions before execution.
- You can install and run a Python tool and are comfortable configuring shell aliases.
- You value the MIT license and are prepared to maintain custom rules or handle issues without recent upstream activity.
Look elsewhere if
- You need a project with recent commits, releases, or active issue handling. The repository is marked inactive, with no recent commits or releases and no issues closed in the measured recent period.
- You need assurances of continuing upstream maintenance. The project has many contributors, and contributions are not concentrated in one person, but that does not offset the lack of recent activity.
- You need an automatic fix without reviewing what it will execute. The tool can require confirmation, but its purpose is still to run corrected shell commands.
All health signals
| Last commit | 2024-07-19 (2.2 years ago) |
|---|---|
| Commits, last 90 days | 0 |
| Releases, last 12 months | 0 (latest 3.32, 2022-01-02) |
| Contributors | 100+ (top contributor: 61% of commits) |
| Issues closed, last 90 days | 0 |
| Project age | 11 years |
Checked on 2026-10-07 with the GitHub API.
Project history
Daily GitHub snapshots since Oct 7, 2026. History covers stars and forks; health signals are not tracked historically.
Stars
97,961Forks
3,980Change since Nov 17, 2026: +5 stars·0 forks
Overview
The Fuck is a Python command-line utility that examines the output of your last failed command and matches it against correction rules. It can suggest a replacement, such as adding sudo after a permissions error or correcting a misspelled Git subcommand, and lets you review the result before running it.
It is aimed at people who work in a shell and regularly encounter small, recognizable command mistakes. Its large collection of built-in rules and support for custom rules make it adaptable, though the project has had no commits or releases recently.
Key Features
- Suggests replacement commands by matching previous command output against rules.
- Includes corrections for shell commands and tools such as Git, Docker, Python, npm, and package managers.
- Supports a confirmation step before running a suggested command, with options to skip confirmation or retry corrections recursively.
- Lets users enable, exclude, and prioritize rules through settings or environment variables.
- Supports custom Python rules and third-party rule packages.
- Offers an experimental instant mode for Bash and Zsh that logs command output to reduce wait time.
Use Cases
- A developer who mistypes a Git subcommand can use a suggested correction instead of looking up the right syntax.
- A Linux user who runs an install command without sufficient permissions can review a version prefixed with
sudo. - Shell users who often forget flags or command syntax can use rules for tools such as
grep,npm,Docker, orpip. - A team with recurring internal command errors can write custom rules, provided it can maintain Python-based integrations itself.
What you need
Detected in the repository
- Python (from setup.py)
- A test suite and automated checks on GitHub Actions
License in plain words
MITpermissive
- Commercial use: yes
- Modify and redistribute: yes
- You must keep: the copyright and license notice
- Share your changes: no
A summary, not legal advice: the LICENSE file is what applies.
Getting Started
Install with pip and add the alias initialization to your shell configuration:
pip install thefuck
eval $(thefuck --alias)
Start a new shell session, then run fuck after a failed command. See the README for platform-specific installation and configuration details.
Considerations
The project is marked inactive: it has had no commits in over a year, no releases in over a year, and no issues closed in the measured recent period. Although the contributor base is not concentrated in one person, teams should not assume fixes or compatibility updates will arrive promptly. The README lists Python 3.5 or later as a requirement, and shell alias setup is necessary for the usual workflow. Suggested commands can have side effects, so review them before execution, especially when using options that bypass confirmation. The project is licensed under MIT; consult the license file for its terms.
Found this useful?
Share it with someone who would like thefuck.