Thanks to visit codestin.com
Credit goes to github.com

Skip to content

Lightning fast smart search for your command history

License

Notifications You must be signed in to change notification settings

mitchins/FuzzyShell

Repository files navigation

FuzzyShell Mascot

Lightning-fast semantic search for your shell history. Press Ctrl+F and find that command from last week—even if you forgot the exact text.

FuzzyShell

FuzzyShell Demo

Install (30 seconds)

curl -sSL https://raw.githubusercontent.com/mitchins/fuzzyshell/main/install_standalone.sh | bash

Then reload your shell and press Ctrl+F. That's it. 🎉

What It Does

  • Ctrl+F → Opens semantic search (replaces Ctrl+R)
  • Type naturally → "list files" finds ls -la
  • Understands intent → Finds commands by meaning, not just substrings
  • Smart ranking → Recent + relevant commands first
  • Edit before run → Commands appear in your prompt

Requirements

  • macOS or Linux
  • Python 3.9+
  • Bash or Zsh

More Details

How It Works

FuzzyShell uses ML embeddings + BM25 ranking to understand what you're looking for:

  • "show containers" → docker ps
  • "git uncommit" → git reset HEAD~
  • "find large files" → find . -size +100M

Manual Install

pip install fuzzyshell
fuzzy --install-hook

Commands

  • fuzzy - Open search
  • fuzzy-ingest - Re-scan history
  • fuzzy-rebuild - Rebuild index
  • fuzzy-update - Update to latest

Uninstall

rm -rf ~/.fuzzyshell
# Remove the source line from ~/.zshrc or ~/.bashrc
Contributing

We love contributions! Check out CONTRIBUTING.md.

git clone https://github.com/mitchins/fuzzyshell
cd fuzzyshell
python -m venv venv
source venv/bin/activate
pip install -e ".[test]"
pytest tests/
Tech Stack
  • Search: ONNX-quantized sentence transformers
  • Storage: SQLite with vector search
  • UI: Rich TUI with syntax highlighting
  • Speed: <100ms search on 10k+ commands

License: MIT | Status: 🟢 Active | Report Issues

About

Lightning fast smart search for your command history

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published