fixit

fixit is a terminal application that fixes mistakes in your commands. It is inspired by The Fuck. It is also designed to be fast as fuck (more about that in the motivation section).

See contributing guidelines here. If you want to help fixit move forward, see the roadmap.

How it works?

When you run the fix command, it takes the last command from your shell history and retrieves its output by either:

• Re-running the command, or
• Queriying emulator/multiplexer API (we call this "quick fixes").

Then fixit runs the command and its output through a set of rules to suggest fixes. Then you select a fix and it is automatically run and added to your shell history.

Installation

echo "deb [arch=$(dpkg --print-architecture) trusted=yes] https://eugene-babichenko.github.io/fixit/ppa ./" | sudo tee /etc/apt/sources.list.d/fixit.list > /dev/null
sudo apt update
sudo apt install fixit

yay -S fixit-bin

yay -S fixit

[fixit]
name=fixit GitHub repository
baseurl=https://eugene-babichenko.github.io/fixit/rpm
enabled=1
gpgcheck=0

brew install eugene-babichenko/fixit/fixit

cargo install fixit-cli

You can also download pre-built binaries for Linux (static binaries) and macOS from Releases.

Shell setup

Add the corresponding command to your shell configuration file.

bash:

eval "$(fixit init bash)"

zsh:

eval "$(fixit init zsh)"

fish:

fixit init fish | source

Powershell:

Invoke-Expression (fixit init powershell | Out-String)

Usage

Having a command that broke? Just type fix in your shell.

Configuration

Alias name

You can change the name of the generated alias by providing the --name argument to the init command:

fixit init --name f fish | source

This will generate the alias named f instead of fix.

Fixing

Environment variables:

This configuration is applied immediately, meaning you do not need to re-initialize.

Logging

Logging is implemented via env_logger. Please refer to its documentation to see how to configure the logs.

Quick fixes

Software with quick fixes

Terminal multiplexers:

• tmux
• Zellij

Teminal emulators:

• iTerm
• kitty
• Wezterm
• Terminal.app

A note for kitty users

You don't need to do this, if you use a terminal multiplexer inside kitty.

This is optional, but without this fixit will fall back to just re-running the command, which is going to be slower.

To make quick completions work, you need to enable remote control. This is recommended, because this application uses kitty @ get-text to retrieve the command output. For the best performance and stability you are advised to set up shell integration.

Available rules

• brew_update_upgrade - replace brew update with brew upgrade when trying to update a Homebrew package.
• cargo_clippy_args: a rule for cargo clippy arguments that must be separated by --.
• cargo_install_cwd - fix cargo install without arguments (it requires --path).
• cargo_wrong_command - fix misspelled cargo commands.
• command_not_found - search for misspelled command through $PATH.
• cp_cwd - cp came with only one argument, maybe you want to copy to the current dir?
• cp_dir - add -R to cp when you are attempting to copy a directory.
• git_add_all_lowercase - correct git add -a to git add -A.
• git_branch_exists - fix git checkout -b when trying to checkout an existing branch.
• git_commit_no_changes - suggest using git commit -a.
• git_no_upstream - set upstream branch when pushing.
• git_retag - suggest deleting a git tag and tagging a new commit with it, if the tag already exists.
• git_wrong_command - fix misspelled git commands.
• mkdir_missing_parent - suggest using mkdir -p to create missing in-between directories.
• rm_dir - add -r to rm when trying to remove a directory.
• sudo - prepend with sudo when permission to execute a command was denied.
• taskfile_no_task - suggest task names when trying to run a task from Taskfile.
• uv_unexpected_argument - fix typos in arguments for the uv Python package manager.