search
The search command finds all occurrences of an identifier across your codebase
without making any changes or creating a plan file. This is useful for exploring
where a name is used before deciding to rename it.
renamify search <term> [paths...] [options]Arguments
Section titled “Arguments”<term>- The identifier to search for[paths...]- Optional paths to search (files or directories). Defaults to current directory
Options
Section titled “Options”Include/Exclude Patterns
Section titled “Include/Exclude Patterns”--include <patterns>- Include only files matching these glob patterns (comma-separated)--exclude <patterns>- Exclude files matching these glob patterns (comma-separated)
Case Styles
Section titled “Case Styles”--exclude-styles <styles>- Exclude specific case styles from search--include-styles <styles>- Include additional case styles (title, dot, sentence, lower-sentence, upper-sentence, space-separated, lower-flat, upper-flat)--only-styles <styles>- Use only these case styles (overrides defaults)
Available styles: snake, kebab, camel, pascal, screaming-snake,
train, screaming-train, title, dot, lower-flat, upper-flat,
sentence, lower-sentence, upper-sentence, space-separated (shorthand)
Line Filtering
Section titled “Line Filtering”--exclude-matching-lines <regex>- Skip matches on lines matching this regex pattern
File and Directory Renaming
Section titled “File and Directory Renaming”--no-rename-files- Don’t include file renames in search results--no-rename-dirs- Don’t include directory renames in search results--no-rename-paths- Don’t include any file or directory renames (equivalent to —no-rename-files —no-rename-dirs)
Case Detection
Section titled “Case Detection”--ignore-ambiguous- Ignore mixed-case/ambiguous identifiers that don’t match standard patterns
Atomic Mode
Section titled “Atomic Mode”--atomic-identifiers- Treat the search term as an indivisible unit (no word boundaries)--atomic-search- Same as--atomic-identifiersfor search command--no-atomic-identifiers- Disable atomic mode (override config)--no-atomic-search- Same as--no-atomic-identifiersfor search command
Output Control
Section titled “Output Control”--preview <format>- Preview format:table,diff,matches,summary(default: summary)--output <format>- Output format:summaryorjson(default: summary)--quiet- Suppress all output--fixed-table-width- Use fixed column widths for table output
Acronym Handling
Section titled “Acronym Handling”--no-acronyms- Disable acronym detection--include-acronyms <list>- Additional acronyms to recognize (comma-separated)--exclude-acronyms <list>- Default acronyms to exclude (comma-separated)--only-acronyms <list>- Replace default acronym list (comma-separated)
Other Options
Section titled “Other Options”-u,--unrestricted- Reduce smart filtering (can be repeated up to 3 times)-u: Don’t respect .gitignore files-uu: Don’t respect any ignore files, include hidden files-uuu: Same as -uu, plus treat binary files as text
-C <path>- Run as if started in the specified directory--no-color- Disable colored output
Examples
Section titled “Examples”Basic Search
Section titled “Basic Search”Search for all occurrences of “getUserData”:
renamify search getUserDataSearch in Specific Directory
Section titled “Search in Specific Directory”renamify search oldFunction src/Search with Table Output
Section titled “Search with Table Output”renamify search myVariable --preview tableExclude Test Files
Section titled “Exclude Test Files”renamify search productionCode --exclude "**/*.test.*,**/*.spec.*"Search Only Specific Case Styles
Section titled “Search Only Specific Case Styles”renamify search myIdentifier --only-styles snake,kebabSkip Comments
Section titled “Skip Comments”renamify search importantFunction --exclude-matching-lines "^\\s*//"Search Without File Renames
Section titled “Search Without File Renames”renamify search myFunction --no-rename-pathsIgnore Ambiguous Identifiers
Section titled “Ignore Ambiguous Identifiers”renamify search cleanName --ignore-ambiguousAtomic Search
Section titled “Atomic Search”Search for compound words as single units:
# DocSpring will match as a whole word, not doc_springrenamify search DocSpring --atomic-identifiersJSON Output for Processing
Section titled “JSON Output for Processing”renamify search userData --output json > search-results.jsonComparison with Plan
Section titled “Comparison with Plan”The search command is essentially the plan command without a replacement
term. It shows you where changes would be made but doesn’t create a plan file or
prepare for any modifications.
Use search when you want to:
- Explore where an identifier is used
- Check the scope of a potential rename
- Verify that your patterns are matching correctly
- Generate reports about identifier usage