Using TheFuck: A Python Tool for Automatically Fixing Mistyped Shell Commands

TheFuck is a powerful Python‑written application that detects and corrects errors in console commands, allowing users to fix typos, missing sudo, wrong arguments, and other common mistakes automatically.

Typical scenarios include fixing incorrect git commands, forgotten sudo, missing parameters, and mistyped commands, as illustrated by several example screenshots.

Installation requirements :

Python (2.7+ or 3.3+)

pip

python‑dev

Installation methods :

macOS (Homebrew): brew install thefuck

Ubuntu (apt):

<code>sudo apt update</code>

<code>sudo apt install python3-dev python3-pip</code>

<code>pip3 install --user thefuck</code>

Other systems (pip): pip install --user thefuck

After installation, add the following alias to your shell configuration (e.g., ~/.bashrc or ~/.zshrc ) to enable the tool:

<code>alias fuck='eval $(thefuck $(fc -ln -1)); history -r'</code>

How it works

The package contains hundreds of matching rules that transform erroneous commands into their correct forms. Some representative rules include:

brew_unknown_command : fixes mistyped Homebrew commands (e.g., brew docto → brew doctor ).

cd_parent : inserts a space in cd.. → cd .. .

cd_mkdir : creates a missing directory when cd fails.

git_add : adds missing git add before a commit.

git_push : adds --set-upstream origin $branch when a push fails.

no_command : corrects unknown commands (e.g., vom → vim ).

sudo : prepends sudo when a command lacks permission.

pip_unknown_command : fixes misspelled pip commands (e.g., pip isntall → pip install ).

There are many more rules covering package managers, file operations, keyboard layout, and more, allowing TheFuck to handle a wide range of command‑line errors.