macOS
Homebrewverified · 100%
brew install thefucklocal Homebrew formula metadata
MacPortsverified · 94%
sudo port install thefuckMacPorts ports tree · python/thefuck/Portfile · source: api.github.com
brew
Install thefuck with Homebrew, apk, apt, dnf, MacPorts, pacman
Programmatically correct mistyped console commands. Version 3.32 via Homebrew; verified from local package data.
install
Additional install commands
Linux
Alpine Linux apkverified · 92%
sudo apk add thefuckAlpine Linux edge package indexes · thefuck · source: dl-cdn.alpinelinux.org
Debian aptverified · 92%
sudo apt install thefuckDebian stable package indexes · thefuck · source: deb.debian.org
Fedora dnfverified · 92%
sudo dnf install thefuckFedora Rawhide package metadata · thefuck · source: dl.fedoraproject.org
Arch Linux pacmanverified · 92%
sudo pacman -S thefuckArch Linux sync databases · thefuck · source: geo.mirror.pkgbuild.com
overview
Package summary
Programmatically correct mistyped console commands
Project links
Commands and aliases
- fuck
- thefuck
history
Project history and usage
The Fuck is a Python command-line utility for correcting a previously failed shell command. Its official README presents it as an app inspired by a tweet and built around the `fuck` alias, which lets a user rerun a corrected version of the last command after errors such as missing `sudo`, misspelled Git subcommands, command-not-found typos, or bad package-manager invocations.
Project history
The project grew around a rules engine: the README says it matches the previous command against enabled rules, creates a replacement command, and executes it after confirmation. The rule list spans common developer and system tools, including package managers, Git, Docker, language toolchains, shells, and file utilities, making the project less a spelling corrector than a catalog of everyday terminal failure modes.
Adoption history
The Fuck became unusually visible for a shell helper: the official GitHub page shows tens of thousands of stars and thousands of forks, while the assigned package facts list packages across Homebrew, Debian, Ubuntu, Fedora, Arch, Alpine, MacPorts, and other ecosystems. Its README also documents installation through Homebrew, FreeBSD packages, Chromebrew, Arch packages, and pip, which reflects the tool's spread through both language and OS package-manager culture.
How it is used
The normal workflow is to install the package, add `eval $(thefuck --alias)` to a shell startup file, run a command that fails, and then type the alias to accept or select a corrected command. The README also documents options such as running without confirmation, recursively retrying fixes, customizing rules in `settings.py`, and using environment variables to tune behavior.
Why package nerds care
For package nerds, The Fuck is interesting because many of its examples and built-in rules encode package-manager ergonomics: it can add `sudo` for `apt-get`, correct Chocolatey package suffixes, fix Homebrew- and system-tool-adjacent command mistakes, and turn common install-time errors into repeatable command rewrites. It is also a good example of a package whose memorable command name helped it become a cross-distro terminal utility.
Timeline
- 2017: GitHub tags page shows the 3.23 release.
- 2018: GitHub tags page shows multiple 3.x releases, including 3.26 through 3.28.
- 2022: GitHub tags page shows release 3.32.
- Current README: documents package-manager installation, shell alias setup, rule-based correction, settings.py, and environment-variable configuration.
Related projects
- Related tools in the same terminal-productivity niche include shell history search, command-not-found helpers, package-manager suggestion tools, and shell frameworks that add aliases or completions. The Fuck differs by taking the previous failed command and proposing a runnable replacement.
Sources
- https://github.com/nvbn/thefuck#readme - official README for description, examples, installation methods, alias setup, rule engine, settings.py, and environment variables.
- https://github.com/nvbn/thefuck/tags - official GitHub tags page for release timeline.
- input source_facts.package-manager - assigned package facts list cross-ecosystem package-manager availability.
security posture
Risk level: green
narrow executable package without higher-risk signals.
Risk classifier
green risk · low confidence · appliance
Why
- narrow executable package without higher-risk signals
Signals
- metadata:no-higher-risk-signals
Install behavior
- No Homebrew post-install hook is recorded in formula metadata.
- Homebrew bottle metadata is available for 6 platform targets.
- Installs with 1 runtime dependencies.
Recommended review
Before unattended agent use, check whether the tool reads plaintext credentials, writes remote state, publishes artifacts, or shells out to plugins.
local files
Configuration and credential file locations
These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.
Configuration files
Config paths the tool may read or write during local use.
- Unix
~/.config/thefuck/settings.py
executables
Installed executables
| Command | Kind | Exposure | Note |
|---|---|---|---|
fuck | cli | global executable | |
thefuck | cli | global executable |
freshness
Version and freshness
These signals separate page generation age, package-manager activity, and upstream release comparison. Version lag is warned only when an evidence URL and comparable versions are present.
page generated2026-07-08
manager version3.32
manager updated
local dataok
upstreamnot checked
latest detectednot detected
https://github.com/nvbn/thefuck
- infoNo package-manager update timestamp was available.low confidence
- infoNo cached GitHub release or tag data was available.https://github.com/nvbn/thefucknone confidence
install metadata
Package metadata
| Package key | brew:thefuck |
|---|---|
| Version | 3.32 |
| Package manager | Homebrew |
| Package manager page | https://formulae.brew.sh/formula/thefuck |
| Homepage | https://github.com/nvbn/thefuck |
| Repository | https://github.com/nvbn/thefuck |
| Upstream docs | https://github.com/nvbn/thefuck#readme |
| License | MIT |
| Source archive | https://files.pythonhosted.org/packages/ac/d0/0c256afd3ba1d05882154d16aa0685018f21c60a6769a496558da7d9d8f1/thefuck-3.32.tar.gz |
| Dependencies | python@3.14 |
| Bottle | available (on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux) |
| Homebrew post-install | not defined |
| Service | none declared |
| Caveats | Add the following to your .bash_profile, .bashrc or .zshrc: eval $(thefuck --alias) For other shells, check https://github.com/nvbn/thefuck/wiki/Shell-aliases |
registry facts
Source database details
| Source Database | Homebrew formula API |
|---|---|
| Tap | homebrew/core |
| Full Name | thefuck |
| Version Scheme | 0 |
| Revision | 0 |
| Head Version | HEAD |
| Bottle Stable Root URL | https://ghcr.io/v2/homebrew/core |
| Deprecated | no |
| Disabled | no |
| Keg Only | no |
| URL Keys |
|
source database matches
Other package-manager records
Matches are pulled from external package-manager indexes and kept separate from local Automic Vault package links.
Debian apt95%
thefuck 3.32-0.3
spelling corrector of console commands
https://github.com/nvbn/thefuck
sudo apt install thefuck- Section: python
- Architecture: all
- 8 dependencies
- normalized package name match
- Matched by: Thefuck
Ubuntu apt95%
thefuck 3.29-0.3ubuntu1
spelling corrector of console commands
https://github.com/nvbn/thefuck
sudo apt install thefuck- Section: universe/python
- Architecture: all
- 7 dependencies
- normalized package name match
- Matched by: Thefuck
apk95%
thefuck 3.32-r6
The Fuck is a magnificent app that corrects errors in previous console commands.
https://github.com/nvbn/thefuck
sudo apk add thefuck- License: MIT
- Architecture: x86_64
- Source Package: thefuck
- 1 dependencies
- 1 provides
- normalized package name match
- Matched by: Thefuck
apk95%
thefuck-pyc 3.32-r6
Precompiled Python bytecode for thefuck
https://github.com/nvbn/thefuck
sudo apk add thefuck-pyc- License: MIT
- Architecture: x86_64
- Source Package: thefuck
- 1 dependencies
- normalized package name match
- Matched by: Thefuck
dnf95%
thefuck 3.32-20.fc44
App that corrects your previous console command
https://github.com/nvbn/thefuck
sudo dnf install thefuck- License: MIT
- Category: Unspecified
- Architecture: noarch
- Source Package: thefuck
- 3 dependencies
- 3 provides
- normalized package name match
- Matched by: Thefuck
pacman95%
thefuck 3.32-12
Magnificent app which corrects your previous console command
https://github.com/nvbn/thefuck
sudo pacman -S thefuck- License: MIT
- Architecture: any
- 6 dependencies
- normalized package name match
- Matched by: Thefuck
MacPorts95%
thefuck
sudo port install thefuck- normalized package name match
- Matched by: Thefuck
source trail
Generated from repository data
This page is generated by av-web from the private package SQLite artifact built by scripts/generate-pkg-sqlite.py.
Combined YAML source
View the package source record on GitHub.
Used sources
- Geiger risk classifier
- Nucleus package database
- av.db category and tag curation
- cross-ecosystem install command graph
- curated configuration and credential file locations
- curated package history
- external package-manager database matches
- package relationship graph
- package version freshness
- package-page enrichment