git:20260113.222b7de to git:20260705.e9e4712

---

name: find-replace

description: "Modern find-and-replace using sd (simpler than sed) and batch replacement patterns. Triggers on: sd, find replace, batch replace, sed replacement, string replacement, rename."

compatibility: "Requires sd CLI tool. Install: brew install sd (macOS) or cargo install sd (cross-platform)."

allowed-tools: "Bash"

---

# Find Replace

Modern find-and-replace using sd.

## sd Basics

```bash

# Replace in file (in-place)

sd 'oldText' 'newText' file.txt

# Replace in multiple files

sd 'oldText' 'newText' *.js

# Preview without changing (pipe)

cat file.txt | sd 'old' 'new'

```

## sd vs sed

| sed | sd |

|-----|-----|

| `sed 's/old/new/g'` | `sd 'old' 'new'` |

| `sed -i 's/old/new/g'` | `sd 'old' 'new' file` |

| `sed 's#path/to#new/path#g'` | `sd 'path/to' 'new/path'` |

**Key difference:** sd is global by default, no delimiter issues.

## Common Patterns

```bash

# Variable/function rename

sd 'oldName' 'newName' src/**/*.ts

# Word boundaries (avoid partial matches)

sd '\boldName\b' 'newName' src/**/*.ts

# Import path update

sd "from '../utils'" "from '@/utils'" src/**/*.ts

# Capture groups

sd 'console\.log\((.*)\)' 'logger.info($1)' src/**/*.js

```

## Safe Batch Workflow

```bash

# 1. List affected files

rg -l 'oldPattern' src/

# 2. Preview replacements

rg 'oldPattern' -r 'newPattern' src/

# 3. Apply

sd 'oldPattern' 'newPattern' $(rg -l 'oldPattern' src/)

# 4. Verify

rg 'oldPattern' src/ # Should return nothing

git diff # Review changes

```

## Special Characters

| Character | Escape |

|-----------|--------|

| `.` | `\.` |

| `*` | `\*` |

| `[` `]` | `\[` `\]` |

| `$` | `\$` |

| `\` | `\\` |

## Tips

| Tip | Reason |

|-----|--------|

| Always preview with `rg -r` first | Avoid mistakes |

| Use git before bulk changes | Easy rollback |

| Use `\b` for word boundaries | Avoid partial matches |

| Quote patterns | Prevent shell interpretation |

## Additional Resources

For detailed patterns, load:

- `./references/advanced-patterns.md` - Regex, batch workflows, real-world examples