cmdfinder 1.1.0

Search and run shell history with a Textual TUI

CmdFinder

CmdFinder is a terminal-based user interface (TUI) that lets you fuzzy-search, browse, and execute commands from your shell history. It’s built with Textual and RapidFuzz.

---

Features

• 🔍 Fuzzy Search: Quickly find commands even if you don’t remember the exact syntax.
• 🐚 Shell Support: Reads history from:
  • Zsh: ~/.zsh_history
  • Bash: ~/.bash_history
• ⚡ Instant Execution: Select a command and run it immediately in your shell.
• 🧭 Vim-like Navigation: Navigate with j / k.
• 🕒 Timestamps: Toggle timestamps on/off.
• 🎨 Modern TUI: Built using Textual.

---

Requirements

• Python 3.10+
• Bash/Zsh or compatible shell
• Read access to history files

---

Installation

pip install cmdfinder

Run:

cmdfinder

or

cf

If the command is not found, add ~/.local/bin to PATH:

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

Or for zsh:

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

---

Install from Source

git clone https://github.com/pranav5127/CmdFinder.git
cd cmdfinder

(Optional) create a virtual environment:

python -m venv .venv
source .venv/bin/activate

Install in editable mode:

pip install -e .

Run:

cmdfinder

---

Usage

To start the TUI:

cmdfinder

Key Bindings

Key	Action
j	Move down
k	Move up
↓ / ↑	Move cursor
Ctrl+s	Focus search
l / Ctrl+l	Focus list
t	Toggle timestamps
Enter	Run selected command
q	Quit

---

Run locally:

cmdfinder

or

python -m cmdfinder.app

---

License

CmdFinder is released under the MIT License.