Skip to content

The Bleep 4.0.0 — the maintained successor to The Fuck

Choose a tag to compare

View all tags
@stamparm stamparm released this 19 Aug 11:10
· 12 commits to master since this release
4.0.0
8789bd5

The first release of The Bleep, and the first maintained release of this codebase since The Fuck 3.32.

The idea is still the same:

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

The Bleep carries The Fuck forward rather than replacing it with a different kind of tool: the familiar rule-based corrections, settings and workflow are still here, with four years of compatibility, safety, performance and usability work on top.

Get it

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

Or:

uv tool install thebleep
# or
pipx install thebleep

The installer does not use sudo or modify your shell files. It prints the one line needed to enable bleep.

What's new

  • Maintained on current Python and current tools. Python 3.9–3.14, modern Linux/macOS/Windows, Bash, Zsh, Fish, tcsh, PowerShell and Nushell.
  • Safer by default. Corrections are confirmed before execution, replay of a previous command is explicit, and multiple command-generation and command-injection problems inherited from the old codebase are fixed.
  • Edit before running. Press tab on a suggestion and, where the shell supports it, the corrected command is handed back to your command line for editing instead of being executed.
  • Ask why. Press ? or use --explain to see which rule produced a suggestion, what matched, and what accepting it will do.
  • thebleep --doctor. One safe-to-paste diagnostic for shell integration, configuration, PATH, rule packs, cache and other common installation issues.
  • Nushell support. Including shell integration, history, quoting, command chaining and edit-in-buffer behaviour.
  • Wrapped commands work properly. Commands behind sudo, doas, env, nice, nohup, setsid, stdbuf, command and builtin can be corrected without losing the wrapper.
  • A lot less waiting. On the reproducible Linux benchmark used for this release, opening a shell dropped from 210 ms to 28 ms, a normal mistyped command from 246 ms to 56 ms, and correction after 1 MB of output from 3.25 s to 117 ms.

There are 173 bundled rules, including fixes and updates for years of drift in Git, pip, npm, Docker, Homebrew, pacman/AUR helpers and many others.

Coming from The Fuck

You do not have to relearn it.

Your settings and custom rules can be copied over, and if four years of muscle memory have made fuck permanent:

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

works too.

The Bleep is based on the original codebase by Vladimir Iakovlev and its contributors. Their work and Git history remain credited.

For the full list of fixes, compatibility work, upstream issues and pull requests addressed in 4.0.0, see the changelog:

https://github.com/stamparm/thebleep/blob/4.0.0/CHANGELOG.md

Assets 2
Loading