welp 0.3.1

project ❯ gti status
zsh: command not found: gti
project ❯ welp
 welp  git status  ↵ run · esc nah

Why welp

thefuck is one of the most-loved command-line tools ever made. It has also had no release since January 2022, and it breaks on Python 3.12 and newer (No module named 'imp'). welp keeps what made it great and quietly fixes the rest.

Speed measured on a MacBook Pro with welp fix; your numbers will vary.

Everything thefuck does, welp does

• All 168 rules, under the same names, so exclude_rules and rules from your thefuck settings keep working
• bash, zsh, fish, tcsh and PowerShell, each tested in CI by mistyping a command and running fuck --yeah
• fuck, fuck --yeah / -y, and picking between fixes with the arrow keys
• macOS, Linux and Windows
• Your own rules (TOML here instead of Python)
• Your settings: welp migrate moves settings.py, your alias and your shell config over in one go

Meet the voice

welp is lowercase, low-key and a little dry. It shrugs when it has nothing, has a line for particular fixes, marks milestones and notices when you keep making the same typo:

project ❯ welp
 welp  git status
        gti → git, 10 times now. we don't have to talk about it.

project ❯ welp
 welp  ¯\_(ツ)_/¯  nothing to fix here. that one's all you.

Pick a voice in your settings: chill (the default, a line now and then), spicy (teases you every time) or quiet (just the fix).

welp stats shows what it remembers:

project ❯ welp stats
 welp  your mistakes, lovingly kept

        fixes         142 since oct 22, 2026
        favorite rule git_push (38)
        top typos     gti → git (14) · sl → ls (5) · pyhton → python (3)
        verdict       you and git have a thing going on.

It keeps only counts, rule names and the mistyped words, never your commands, in ~/.local/state/welp/stats.toml. Set remember = false to turn it off.

Install

brew install oliv3rmoon/tap/welp    # macOS and Linux
cargo install welp                   # anywhere with Rust

Or grab a prebuilt binary for macOS, Linux or Windows from the releases page, unpack it and put welp somewhere on your PATH.

Set up

Add one line to your shell config, then open a new terminal:

Prefer another word? Add --alias, for example eval "$(welp init zsh --alias oops)".

Coming from thefuck

welp migrate --dry-run   # see what would change
welp migrate             # do it

It comments out the thefuck lines in your shell config (bash, zsh, fish, tcsh or PowerShell, with a backup next to each file), adds welp in their place with your alias, and turns ~/.config/thefuck/settings.py into ~/.config/welp/config.toml, including your exclude_rules and any extra rules you turned on.

Rules

welp has all of thefuck's rules (168 of them, with the same names) plus did_you_mean, which uses the fix a tool suggests itself. The everyday ones:

Seven rules are off by default because their fix deletes, force-pushes, kills or removes something the typed command didn't ask to: git_push_force, git_tag_force, port_already_in_use, rm_root, ssh_known_hosts, django_south_ghost and docker_image_being_used_by_container. Turn one on with enable_rules. welp rules lists every rule and which are off.

Settings

~/.config/welp/config.toml (or $XDG_CONFIG_HOME/welp/config.toml):

require_confirmation = true   # false runs the first fix straight away
wait_command = 3              # seconds to wait when reading a command's output
wait_slow_command = 15
slow_commands = ["lein", "react-native", "gradle", "./gradlew", "vagrant"]
no_rerun = ["rm", "mv", "dd", "vim", "ssh"]  # never run these twice (the full default list is longer)
exclude_rules = []
enable_rules = []             # opt into the 7 rules that are off by default
voice = "chill"               # chill, spicy or quiet
remember = true               # false stops welp stats from counting

Set NO_COLOR to drop the colours; welp keeps the words.

Your own rules

Teach welp a fix without writing code: drop a TOML file in ~/.config/welp/rules/.

# ~/.config/welp/rules/please.toml
name = "please"
description = "please → sudo"
script = '^please (?P<rest>.+)$'
fix = "sudo {rest}"

A rule can check the program, a regex on the command (script) and a regex on what it printed (output). Its fix (or a list of fixes) can use {script} and any named group from those regexes. Your fixes are offered first; add first = false to offer them after welp's own. welp rules lists yours and says what's wrong with any file it can't read.

Adding a rule to welp

A rule is a name, a check and a fix, in src/rules/. Each comes with a test that feeds it a command and the output a real tool printed:

Rule {
    name: "mkdir_p",
    description: "Adds -p when parent folders are missing",
    priority: 1000,
    matches: |c| c.is("mkdir") && c.output_lower().contains("no such file or directory"),
    fixes: |c| vec![c.replace_word("mkdir", "mkdir -p")],
},

Run cargo test before opening a pull request.

The demo above is a real session: demo/record.sh sets up a throwaway repo and types the commands into zsh.

Support

If welp saves you some typing, you can buy me a coffee or come hang out on Discord.

Credits

welp's rules are ports of thefuck's, by Vladimir Iakovlev and its contributors (MIT). welp is not affiliated with thefuck.

License

MIT