nvbn

thefuck: Suggest Fixes for Failed Shell Commands

The Fuck analyzes a failed shell command and suggests a corrected version, with rules for common shell, Git, package-manager, and developer-tool errors. It is useful for command-line users who want quick, reviewable fixes, but its development appears inactive.

InactivePythonMITCLIDeveloper ToolsShell
View on GitHub Compare
Stars
97.9k
Forks
4k
Stars, last 30 days
+47
Last commit
2.2 years ago
Contributors
100+

Our take

Inactiveno commits in over a year

Health score

34/100

How it is scored
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 commit2024-07-19 (2.2 years ago)
Commits, last 90 days0
Releases, last 12 months0 (latest 3.32, 2022-01-02)
Contributors100+ (top contributor: 61% of commits)
Issues closed, last 90 days0
Project age11 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.

Selected snapshot

Stars

97,961

Forks

3,980

Change 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, or pip.
  • 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.