---
name: file-finder
version: 1.0.0
description: >-
  Find files matching a name pattern in a directory. Use when the user wants
  to locate files by name, extension, or wildcard pattern.
allowed-tools: Bash(find:*,sort:*,head:*)
metadata: >-
  {"openclaw":{"emoji":"📂","requires":{"bins":["find","sort","head"],"env":[]},"install":[]}}
---

# File Finder / 파일 찾기

Find files matching a name pattern in a directory.
디렉토리에서 이름 패턴과 일치하는 파일을 찾습니다.

## Usage / 사용법

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

**Arguments / 인수:**
| # | Name | Description | 설명 |
|---|------|-------------|------|
| 1 | PATTERN | Filename pattern with wildcards (e.g. `*.txt`) | 와일드카드를 포함한 파일명 패턴 (예: `*.txt`) |
| 2 | DIRECTORY | Directory to search in (default: current) | 검색할 디렉토리 (기본값: 현재 디렉토리) |

## Example / 예시

```bash
bash run.sh "*.log" /var/log
```

**Output / 출력:**
```
PATTERN: *.log
DIRECTORY: /var/log
---
/var/log/syslog.log
/var/log/auth.log
---
FOUND: 2
STATUS: OK
```

## Success / Failure — 성공 / 실패

- **Success / 성공**: File list with `FOUND:` count and `STATUS: OK` (exit code 0) — 파일 목록, `FOUND:` 수, `STATUS: OK` (종료 코드 0)
- **Failure / 실패**: `ERROR:` message (exit code non-zero) — `ERROR:` 메시지 (종료 코드 0이 아님)