zsh-autosuggestions
Fish-like fast and unobtrusive autosuggestions for the Zsh shell based on history and completions.
What is zsh-autosuggestions?
zsh-autosuggestions is a Zsh plugin that provides intelligent command suggestions as you type, inspired by the Fish shell. It enhances command-line productivity by predicting commands based on your shell history and completions, reducing typing effort and helping avoid mistakes. The plugin is designed to be fast and unobtrusive, offering suggestions in a muted style that doesn't interfere with your workflow.
Zsh users, particularly developers and system administrators who frequently use the terminal and want to improve their command-line efficiency and recall. It's especially valuable for those familiar with Fish shell's autosuggestion feature and seeking similar functionality in Zsh.
Developers choose zsh-autosuggestions for its seamless, non-intrusive integration that mimics Fish shell's popular autosuggestion experience within Zsh. Its unique selling points include configurable suggestion strategies (history, completion, match_prev_cmd), asynchronous fetching for performance, and extensive customization options for highlighting, key bindings, and widget behavior.
Overview
Fish-like autosuggestions for zsh
Use Cases
Best For
- Zsh users transitioning from Fish shell who want familiar command autosuggestion features.
- Improving terminal productivity by reducing repetitive typing of frequently used or complex commands.
- Enhancing command recall by leveraging shell history and tab-completion suggestions interactively.
- Customizing terminal workflows with configurable suggestion strategies, key bindings, and visual styles.
- Avoiding command entry mistakes by accepting pre-validated suggestions from history or completions.
- Advanced Zsh users needing fine-grained control over autosuggestion behavior via widget mapping and pattern ignoring.
Not Ideal For
- Environments using Zsh versions older than 4.3.11, as the plugin is incompatible and won't function.
- Teams standardized on Bash or Fish shells, where native autosuggestion features or alternative plugins might provide better integration.
- Users who prefer a minimal, plugin-free terminal setup and want to avoid configuration overhead.
- Systems with Zsh versions between 4.3.11 and 5.0.8 where asynchronous mode has known bugs affecting Ctrl+C behavior.
Pros & Cons
Pros
Offers configurable strategies like history, completion, and match_prev_cmd that can be chained, allowing precise control over suggestion sources based on user workflow.
Highly customizable with variables for highlighting styles, widget mapping, and pattern ignoring, as detailed in the README's configuration section.
Fetches suggestions asynchronously by default in Zsh ≥5.0.8, preventing input lag and maintaining terminal responsiveness during use.
Successfully replicates Fish shell's intuitive autosuggestion experience, making it easy for users transitioning to Zsh to adopt.
Cons
Limited to Zsh users and requires version 4.3.11 or later, with asynchronous features buggy in older versions, hindering cross-shell adoption.
Requires manual setup for key bindings, widget mappings, and styling, which can be complex for users not versed in Zsh internals.
As noted in troubleshooting, some terminals like iTerm2 may have visibility problems due to color settings, requiring additional user adjustments.
Frequently Asked Questions
Related Projects
oh-my-zsh🙃 A delightful community-driven (with 2,500+ contributors) framework for managing your zsh configuration. Includes 300+ optional plugins (rails, git, macOS, hub, docker, homebrew, node, php, python, etc), 140+ themes to spice up your morning, and an auto-update tool that makes it easy to keep up with the latest updates from the community.
zoxideA smarter cd command. Supports all major shells.
zsh-syntax-highlightingFish shell like syntax highlighting for Zsh.
autojumpA cd command that learns - easily navigate directories from the command line
Found a gem we're missing?
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.