Thebleep

The Bleep [![Version][version-badge]][version-link] [![Build Status][workflow-badge]][workflow-link] [![MIT License][license-badge]](LICENSE.md)

Type the command wrong. Type `bleep`. Run the right one.


**[Try it in your browser](https://stamparm.github.io/thebleep/)** — the engine itself, compiled to WebAssembly, correcting whatever you type at it. Every answer comes with the confidence, the evidence and the rule that produced it, and nothing on that page can run anything.

*The Bleep* corrects console commands: the one that just failed and, if you let it, the one you are about to run. It reads what the tool printed, what your project declares and what your manual pages say, offers the fix with a confidence and a reason beside it, and never runs anything you did not see first. It grew out of [The Fuck](https://github.com/nvbn/thefuck) by Vladimir Iakovlev and its contributors, whose work stays credited in its history; it keeps their rules, settings and alias, and [what changed](#for-the-fuck-users) is at the end.

Get it

curl -fsSL https://raw.githubusercontent.com/stamparm/thebleep/master/install.sh | sh

That picks up whichever of `uv`, `pipx` or `pip` you already have, and prints the one line to add to your shell's startup file. Prefer to do it yourself:

uv tool install thebleep          # or: pipx install thebleep
thebleep --alias-loader >> ~/.bashrc

Open a new shell, and the next time you mistype something, type `bleep`. [The long version](#installation), including the muscle memory you already have:

thebleep --alias-loader fuck >> ~/.bashrc

What it does

• Fixes the typo before it runs. Return on gti status in zsh, fish or PowerShell replaces the line with git status and waits for a second return; bash has the fix waiting at the next prompt. Nobody types bleep for the commonest mistake there is. [Without typing bleep](#without-typing-