File Finder

What This Skill Does

The File Finder skill acts as a high-performance, user-friendly search utility designed to locate files and directories within your local filesystem. Inspired by the speed and efficiency of the popular fd tool, it leverages rust-based performance to scan your directory structures instantly. Unlike standard system 'find' commands which can be cumbersome and complex, File Finder provides a streamlined syntax that allows you to pinpoint specific assets without navigating through endless subdirectories manually. It is an essential tool for developers and power users who need to manage large codebases or file hierarchies efficiently.

Installation

To integrate this utility into your OpenClaw environment, execute the following command in your terminal:

clawhub install openclaw/skills/skills/ckchzh/file-finder

Once the installation completes, you can verify the status of the skill by running the file-finder status command to ensure all dependencies are correctly initialized.

Use Cases

• Project Navigation: Quickly locate specific source code files within massive projects by name or pattern.
• Cleanup Tasks: Identify and isolate old logs, temporary build artifacts, or duplicate files to recover disk space.
• Asset Management: Locate media assets, configuration files, or documentation snippets within complex directory trees.
• Automation Scripting: Use the skill as part of a larger workflow where programmatic access to file paths is required based on regex patterns.

Example Prompts

1. "File Finder, can you search for all files ending in .rs within the src directory and list them for me?"
2. "Run the File Finder utility to locate any configuration files containing the word 'auth' in my project folder."
3. "OpenClaw, find all files modified recently that match the pattern 'test' so I can review them."

Tips & Limitations

To get the most out of File Finder, take advantage of regex patterns to narrow down your search results significantly. The tool is optimized for speed; however, be aware that scanning your entire root directory may take longer than searching within specific project scopes. While highly efficient, this tool is designed for discovery and listing; it does not perform deletion or modification operations on the files it finds, ensuring that your data remains safe. Always ensure you have the necessary read permissions for the directories you intend to search, otherwise, the skill may return empty results for those specific paths.