text-search

name	text-search
description	Search project files for text or regex patterns, preferring ripgrep when available and falling back to a Python implementation. Use for fast codebase and document text discovery.
version	1.0.0
author	Zijian Guo
license	MIT
platforms	["linux","macos"]
prerequisites	{"commands":["python3"]}
metadata	{"hermes":{"tags":["agent-tools","search","grep","ripgrep","codebase"]}}

text-search - Project text search

Search files with stable line-numbered output. The script uses rg when available and falls back to Python otherwise.

When to Use

• User asks where a symbol, phrase, TODO, route, or setting appears.
• You need evidence before editing code.
• You need context lines around matches.

Script

~/.hermes/skills/text-search/scripts/text_search.py

Options

Option	Default	Description
pattern	required	Text or regex pattern
path	.	File or directory to search
--context	0	Context lines before and after matches
--fixed	off	Treat pattern as literal text
--ignore-case	off	Case-insensitive search
--glob	repeatable	Include/exclude glob passed to rg when available
--max-count	100	Stop after this many printed lines in fallback mode

Pitfalls

• The fallback skips binary-looking files and common dependency directories.
• --glob is only honored by the rg path.