mcfly

mcfly command [options]

mcfly is an intelligent shell history search tool written in Rust that uses a small neural network to suggest the most likely command based on context. It considers working directory, recent commands, exit status, and command patterns.
The tool replaces Ctrl+R with a smarter search that prioritizes commands based on relevance rather than recency alone. It stores history in a SQLite database, which can be rebuilt if deleted.

search [pattern]

Search history for matching commands.

Add a command to the mcfly history database.

Train the neural network suggestion engine.

Record a directory having been moved.

Output shell initialization script (bash, zsh, or fish).

Shell history file to read from when adding or searching.

Session ID to record or search under.

Enable debug output.

Display help information.

Display version information.

Requires shell integration to replace Ctrl+R. The neural network needs time to learn usage patterns; initial suggestions may not be optimal. The SQLite database grows with usage. Set MCFLY_FUZZY (integer, 2-5 recommended) to enable fuzzy matching. Set MCFLY_RESULTS to control the number of results shown (default: 10). Set MCFLY_HISTORY_LIMIT to limit search depth.

mcfly was created by Andrew Cantino to bring intelligent command suggestion to the shell. It uses machine learning principles to provide context-aware history search, going beyond simple text matching.

hstr(1), fzf(1), atuin(1), history(1), bash(1), zsh(1)