fzf-fuzzy-finder

What This Skill Does

fzf-fuzzy-finder is a powerful command-line utility that brings interactive, fuzzy searching to your terminal. Instead of relying on exact matches or complex grep patterns, fzf allows you to find files, commands, process IDs, or git branches by typing partial strings. It acts as an interactive filter that reads input from standard output and lets you select items using keyboard navigation. It supports multi-selection, real-time previews, and customizable key bindings, making it an essential tool for developers and power users who want to accelerate their workflow in the shell, vim, or other CLI environments.

Installation

To integrate this skill with your OpenClaw environment, execute the following command in your terminal: clawhub install openclaw/skills/skills/arnarsson/fzf-fuzzy-finder

Ensure you have fzf installed on your host system. Once installed, source the completion and key-binding scripts provided in the fzf installation directory (typically found in your ~/.bashrc or ~/.zshrc) to unlock features like Ctrl+R for history search and Ctrl+T for file discovery.

Use Cases

This skill is highly versatile. You can use it for:

• File Navigation: Quickly locate files in deep directory structures or preview file contents before opening them in an editor.
• Process Management: Search through active processes and kill specific tasks without typing long PID sequences.
• Git Workflow: Efficiently manage branches, view commit logs, and stage specific files by fuzzy searching through your git status output.
• Command History: Instead of scrolling through thousands of lines of command history, search for past commands instantly with a few keystrokes.
• Script Enhancement: Build interactive interfaces for your own scripts by piping data through fzf to let users make selections.

Example Prompts

1. "Use fzf to list all files in the current directory and open the selected file in vim with a preview window showing the first 50 lines."
2. "Help me kill a specific node process by fuzzy searching through the process list and returning the PID to the kill command."
3. "Show me a list of my recent git commits using fzf, and once I select one, display the diff for that specific commit using git show."

Tips & Limitations

• Previews: Use the --preview flag combined with bat for colorized output, which significantly improves readability.
• Filtering: Remember that fzf defaults to fuzzy matching, but you can use ! to exclude patterns, or use the | operator for OR queries.
• Key Bindings: Take advantage of the --bind flag to define custom actions, such as automatically opening files in a specific editor or copying file paths to the system clipboard.
• Limitations: fzf is a filter, not a file system traversal tool; it performs best when piped from efficient generators like find, fd, or rg.