# Which Shells Are Supported by thefuck? A Complete Guide to Shell Compatibility > Discover which shells thefuck supports. Get a complete guide to shell compatibility for Bash, Zsh, Fish, Tcsh, PowerShell, and more. - Repository: [Vladimir Iakovlev/thefuck](https://github.com/nvbn/thefuck) - Tags: getting-started - Published: 2026-02-27 --- **Thefuck supports Bash, Zsh, Fish, Tcsh (including Csh), and PowerShell, with a generic fallback for unrecognized shells.** The open-source command correction tool `thefuck` (maintained in the **nvbn/thefuck** repository) automatically detects your current interactive shell and loads a specialized implementation to handle alias expansion, history manipulation, and syntax generation. Understanding which shells are officially supported helps you configure the tool correctly for your environment. ## Supported Shells in thefuck The detection logic resides in [[`thefuck/shells/__init__.py`](https://github.com/nvbn/thefuck/blob/main/thefuck/shells/__init__.py)](https://github.com/nvbn/thefuck/blob/master/thefuck/shells/__init__.py), which maps shell identifiers to concrete classes. Each class implements methods for alias parsing, history file access, and version detection. ### Bash **Bash** is fully supported through the `Bash` class in [[`thefuck/shells/bash.py`](https://github.com/nvbn/thefuck/blob/main/thefuck/shells/bash.py)](https://github.com/nvbn/thefuck/blob/master/thefuck/shells/bash.py). This implementation handles standard Bash alias expansion, reads from `~/.bash_history`, and generates the appropriate `eval` alias syntax for your `.bashrc` file. ### Zsh **Zsh** support is provided by the `Zsh` class in [[`thefuck/shells/zsh.py`](https://github.com/nvbn/thefuck/blob/main/thefuck/shells/zsh.py)](https://github.com/nvbn/thefuck/blob/master/thefuck/shells/zsh.py). The implementation accounts for Zsh's extended history format and complex alias definitions, ensuring that corrected commands are properly inserted into `~/.zsh_history` with correct timestamps. ### Fish Shell **Fish** (Friendly Interactive Shell) is supported via the `Fish` class in [[`thefuck/shells/fish.py`](https://github.com/nvbn/thefuck/blob/main/thefuck/shells/fish.py)](https://github.com/nvbn/thefuck/blob/master/thefuck/shells/fish.py). This implementation uses Fish-specific function definitions rather than traditional aliases and handles Fish's unique history file format located at `~/.local/share/fish/fish_history`. ### Tcsh and Csh **Tcsh** (and its compatible predecessor **Csh**) are supported through the `Tcsh` class in [[`thefuck/shells/tcsh.py`](https://github.com/nvbn/thefuck/blob/main/thefuck/shells/tcsh.py)](https://github.com/nvbn/thefuck/blob/master/thefuck/shells/tcsh.py). The implementation handles the distinct C-shell syntax for aliases and history management, recognizing both `tcsh` and `csh` as valid shell identifiers. ### PowerShell **PowerShell** (including `powershell` and `pwsh` on Windows) is supported via the `Powershell` class in [[`thefuck/shells/powershell.py`](https://github.com/nvbn/thefuck/blob/main/thefuck/shells/powershell.py)](https://github.com/nvbn/thefuck/blob/master/thefuck/shells/powershell.py). This implementation interfaces with Windows command history and generates PowerShell-specific alias syntax for your `$profile` configuration. ### Generic Fallback For any unrecognized shell, `thefuck` falls back to the `Generic` class in [[`thefuck/shells/generic.py`](https://github.com/nvbn/thefuck/blob/main/thefuck/shells/generic.py)](https://github.com/nvbn/thefuck/blob/master/thefuck/shells/generic.py). This provides minimal functionality—basic command correction without alias expansion or history integration—ensuring the tool remains usable even in exotic shell environments. ## How thefuck Detects Your Shell The shell detection mechanism in [[`thefuck/shells/__init__.py`](https://github.com/nvbn/thefuck/blob/main/thefuck/shells/__init__.py)](https://github.com/nvbn/thefuck/blob/master/thefuck/shells/__init__.py) builds a mapping of shell names to classes and inspects the parent process or environment variables to determine the current shell. When you invoke `thefuck`, it automatically instantiates the appropriate shell class to handle: - **Alias expansion** — Resolving user-defined shortcuts before correction - **History manipulation** — Reading the failed command and writing the corrected version - **Syntax generation** — Formatting the fix command according to shell-specific rules ## Setting Up thefuck Aliases for Your Shell To use `thefuck`, you must add a shell-specific alias to your configuration file. The tool can generate the correct syntax automatically. ### Bash and Zsh Configuration For **Bash** or **Zsh**, append the alias to your respective rc file: ```bash # Bash thefuck --alias >> ~/.bashrc # Zsh thefuck --alias >> ~/.zshrc ``` The generated alias uses `eval` to capture the corrected command and add it to history. ### Fish Configuration For **Fish**, pipe the output directly to `source` or save it to your functions directory: ```bash thefuck --alias | source ``` Alternatively, save it permanently: ```bash thefuck --alias > ~/.config/fish/functions/fuck.fish ``` ### PowerShell Configuration For **PowerShell**, append the alias to your profile: ```powershell thefuck --alias | Out-File -Append $profile ``` This creates a function in your PowerShell profile that invokes the correction logic. ### Enabling Instant Mode **Instant mode** allows `thefuck` to execute the corrected command immediately without requiring an additional Enter press. Enable it by setting the environment variable before generating the alias: ```bash export THEFUCK_INSTANT_MODE=true thefuck --alias >> ~/.bashrc ``` ## Summary - **thefuck** officially supports **Bash**, **Zsh**, **Fish**, **Tcsh/Csh**, and **PowerShell** through dedicated implementations in `thefuck/shells/`. - Shell detection occurs automatically in [`thefuck/shells/__init__.py`](https://github.com/nvbn/thefuck/blob/main/thefuck/shells/__init__.py), which maps process names to concrete classes like `Bash`, `Zsh`, and `Fish`. - Each shell class handles alias expansion, history file manipulation, and syntax generation specific to that shell's requirements. - An unrecognized shell triggers the `Generic` fallback in [`thefuck/shells/generic.py`](https://github.com/nvbn/thefuck/blob/main/thefuck/shells/generic.py), providing basic correction without history integration. - Setup requires generating a shell-specific alias using `thefuck --alias` and appending it to the appropriate configuration file (`.bashrc`, `.zshrc`, Fish functions, or PowerShell `$profile`). ## Frequently Asked Questions ### How does thefuck determine which shell I am using? Thefuck inspects the parent process and environment variables to identify your current shell. The detection logic in [`thefuck/shells/__init__.py`](https://github.com/nvbn/thefuck/blob/main/thefuck/shells/__init__.py) maintains a registry mapping shell names (like `bash`, `zsh`, or `fish`) to their respective implementation classes. When you run the tool, it automatically instantiates the correct class for your environment. ### Can I use thefuck with a shell that is not officially supported? Yes. If thefuck encounters a shell it does not recognize (anything other than Bash, Zsh, Fish, Tcsh, or PowerShell), it falls back to the `Generic` class defined in [`thefuck/shells/generic.py`](https://github.com/nvbn/thefuck/blob/main/thefuck/shells/generic.py). This fallback provides basic command correction functionality but cannot expand aliases or write corrections back to your shell's history file. ### What is the difference between thefuck's normal mode and instant mode? In normal mode, thefuck displays the corrected command and requires you to press Enter to execute it. In **instant mode**, enabled by setting `THEFUCK_INSTANT_MODE=true` before generating your alias, the corrected command executes immediately without additional confirmation. Instant mode requires shell-specific handling in the alias generation logic found in each shell's implementation file (e.g., [`thefuck/shells/bash.py`](https://github.com/nvbn/thefuck/blob/main/thefuck/shells/bash.py)). ### How do I permanently add the thefuck alias to PowerShell? To permanently configure thefuck for PowerShell, generate the alias and append it to your PowerShell profile file. Run `thefuck --alias | Out-File -Append $profile` in a PowerShell session. This command adds the necessary function definition to your `$profile` script, which loads automatically whenever you start a new PowerShell session. The implementation details for PowerShell-specific syntax are handled in [`thefuck/shells/powershell.py`](https://github.com/nvbn/thefuck/blob/main/thefuck/shells/powershell.py).