ripgrep

What This Skill Does

The ripgrep (rg) skill provides a high-performance text search engine that acts as a modern, vastly superior alternative to traditional Unix grep. Designed for developers and power users, it scans large codebases with incredible speed by utilizing parallelism and SIMD acceleration. A standout feature of ripgrep is its intelligence: it automatically respects your .gitignore files, meaning it will not waste time indexing your node_modules, build artifacts, or secret keys unless explicitly told otherwise. By default, it ignores hidden files and binary files, providing a clean, noise-free output that includes line numbers, colors, and context.

Installation

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

clawhub install openclaw/skills/skills/arnarsson/ripgrep

Ensure that you have sufficient permissions in your project directory to allow the tool to read files. Once installed, it will be available as an agent skill, allowing you to invoke search operations across any codebase managed within your workspace.

Use Cases

Ripgrep is ideal for any scenario involving large-scale text searching within directories. Use it to audit codebases for security vulnerabilities, such as finding instances of hardcoded API keys or outdated library versions. It is also an essential tool for refactoring: quickly locate all occurrences of a specific function name or variable before applying a global change. Because it supports regex, you can find complex code patterns like unclosed braces, inconsistent log statements, or multi-line function definitions. Finally, it serves as a powerful navigation aid, helping you identify which files contain specific logical flows or configurations without manually opening hundreds of files in an IDE.

Example Prompts

1. "ripgrep search for the string 'user_auth' inside all Python files in the current project."
2. "Find all instances of 'TODO' in the src directory and show me 2 lines of context for each match."
3. "List all filenames that contain the pattern 'database_connection' while ignoring the test folder."

Tips & Limitations

Performance is at its peak when searching through large directories, but be aware that using overly complex regex patterns can slightly reduce search speed. Always use the -t flag for file-type filtering rather than manual path inclusions to keep commands concise. If you are searching in a directory that is not a Git repository, keep in mind that the tool will still operate, but it will lose the auto-ignore benefits unless you use specific flag overrides like --no-ignore. To see the performance metrics of a search, always append the --stats flag to your request to monitor how many files were scanned and how long the operation took. Note that ripgrep is a read-only tool; it does not modify your files directly, which makes it safe to run on any production codebase.