mcfly
McFly replaces your shell's ctrl-r history search with an intelligent neural network-powered engine that prioritizes commands based on context.
What is mcfly?
McFly is an intelligent shell history search tool that replaces the default ctrl-r functionality. It uses a neural network to prioritize command suggestions based on your current working directory, recent command context, frequency, and exit status, making it faster to find and reuse past commands.
Developers and system administrators who work extensively in the terminal and want a smarter, more efficient way to search and reuse shell command history across Bash, Zsh, and PowerShell.
McFly offers a significant upgrade over basic shell history search by using real-time neural network ranking to surface contextually relevant commands, reducing keystrokes and improving workflow efficiency without disrupting existing shell setups.
Overview
Fly through your shell history. Great Scott!
Use Cases
Best For
- Improving terminal productivity with context-aware command history
- Reducing repetitive typing of complex or frequently used shell commands
- Searching shell history based on directory or project context
- Managing and filtering command history with regex or fuzzy search
- Switching between Bash, Zsh, and PowerShell with consistent history search
- Analyzing command usage patterns with metadata like exit status and timestamps
Not Ideal For
- Environments with strict resource constraints where neural network inference adds unacceptable overhead
- Teams requiring actively maintained projects with frequent updates and robust support
- Users on unsupported shell versions or niche shells not covered by McFly's compatibility list
- Systems where minimal shell modifications are preferred to avoid configuration complexity
Pros & Cons
Pros
Uses a real-time neural network to prioritize commands based on directory, recent context, frequency, and exit status, making suggestions highly relevant to your current workflow.
Supports Zsh, Bash 3+, and PowerShell 7+, with installation scripts for each, ensuring consistent history search across different terminal environments.
Maintains original shell history files and uses a separate SQLite database, allowing users to revert without data loss, as emphasized in the features.
Offers fuzzy search, regex filtering for history dumps, and wildcard matching with '%', providing powerful options beyond basic ctrl-r search.
Cons
The README explicitly states the project is seeking co-maintainers, indicating potential for slow updates, bug fixes, and limited long-term support.
Installation requires editing shell config files and setting environment variables for customization, which can be error-prone and intimidating for less technical users.
Admits to slow startup with very large history databases, necessitating manual limits via MCFLY_HISTORY_LIMIT, which can impact usability.
Does not parse or use HISTTIMEFORMAT, which may break compatibility with some shell history setups and reduce functionality for users relying on timestamps.
Frequently Asked Questions
Related Projects
fuckMagnificent app which corrects your previous console command.
fzf:cherry_blossom: A command-line fuzzy finder
ripgrepripgrep recursively searches directories for a regex pattern while respecting your gitignore
BatA cat(1) clone with wings.
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.