fuck
A command-line tool that automatically corrects errors in your previous console command.
What is fuck?
The Fuck is a command-line utility that analyzes the output of your last failed command and suggests a corrected version. It saves time and reduces frustration by fixing common typos, missing permissions, incorrect arguments, and other shell mistakes with a simple invocation.
Command-line users, especially developers and system administrators who frequently work in Bash, Zsh, Fish, or other shells and want to reduce time spent on trivial errors.
Developers choose The Fuck for its extensive library of over 100 built-in rules covering tools like git, apt, docker, and npm, its extensibility with custom rules, and its interactive confirmation that prevents accidental execution of incorrect fixes.
Overview
Magnificent app which corrects your previous console command.
Use Cases
Best For
- Fixing permission-denied errors by automatically prepending 'sudo' to commands.
- Correcting misspelled git commands like 'git brnch' to 'git branch'.
- Adding missing upstream branches when 'git push' fails.
- Installing packages with apt-get when permission errors occur.
- Running Python scripts that fail due to command-not-found typos like 'puthon'.
- Creating directories automatically when commands like 'mkdir' or 'cp' fail due to missing parent directories.
Not Ideal For
- Scripted or non-interactive environments where command output is not captured for analysis.
- Teams using proprietary or niche command-line tools without existing rules, requiring custom development.
- Users with strict security policies that prohibit shell aliasing or automatic command execution.
Pros & Cons
Pros
With over 100 built-in rules for tools like git, apt, and docker, it automatically fixes common typos, permission issues, and argument errors, as demonstrated in the README examples such as correcting 'git brnch' to 'git branch'.
Interactive confirmation by default prevents accidental execution of incorrect fixes, and settings allow customization, including the --yeah flag for automatic correction or disabling confirmation entirely.
Supports custom rule creation in Python, enabling users to add corrections for specific workflows, with detailed documentation in the 'Creating your own rules' section.
Works with Bash, Zsh, Fish, and others via simple alias setup, as shown in the installation instructions for adding eval commands to shell config files.
Cons
Instant mode for faster corrections only supports Python 3 with bash or zsh and requires disabling zsh's autocorrect, limiting its use in diverse or restricted environments.
Requires Python 3.5+, pip, and shell configuration, which can be cumbersome for users on minimal systems or those preferring plug-and-play tools without additional dependencies.
With numerous rules and configurable settings, tuning enabled rules or priorities might overwhelm casual users, as indicated by the extensive settings.py and environment variable options.
Frequently Asked Questions
Related Projects
yt-dlpA feature-rich command-line audio/video downloader
youtube-dlCommand-line program to download videos from YouTube.com and other video sites
fzf:cherry_blossom: A command-line fuzzy finder
ripgrepripgrep recursively searches directories for a regex pattern while respecting your gitignore
Found a gem we're missing?
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.