---
name: text-search
version: 1.0.0
description: >-
  Search for a text pattern in files within a directory. Use when the user wants
  to find which files contain a specific word or phrase.
allowed-tools: Bash(grep:*)
metadata: >-
  {"openclaw":{"emoji":"🔍","requires":{"bins":["grep"],"env":[]},"install":[]}}
---

# Text Search / 텍스트 검색

Search for a text pattern in files within a directory.
디렉토리 내 파일에서 텍스트 패턴을 검색합니다.

## Usage / 사용법

```bash
bash run.sh <PATTERN> [DIRECTORY]
```

**Arguments / 인수:**
| # | Name | Description | 설명 |
|---|------|-------------|------|
| 1 | PATTERN | Text or regex pattern to search for | 검색할 텍스트 또는 정규식 패턴 |
| 2 | DIRECTORY | Directory to search in (default: current) | 검색할 디렉토리 (기본값: 현재 디렉토리) |

## Example / 예시

```bash
bash run.sh "TODO" /home/user/project
```

**Output / 출력:**
```
PATTERN: TODO
DIRECTORY: /home/user/project
---
/home/user/project/main.py:12:# TODO: fix this
/home/user/project/utils.py:5:# TODO: add tests
---
MATCHES: 2
STATUS: OK
```

## Success / Failure — 성공 / 실패

- **Success / 성공**: Matching lines with `MATCHES:` count and `STATUS: OK` (exit code 0) — 일치하는 줄과 `MATCHES:` 수, `STATUS: OK` (종료 코드 0)
- **Failure / 실패**: `ERROR:` message (exit code non-zero) — `ERROR:` 메시지 (종료 코드 0이 아님)