검색·탐색 도구

이 계열은 "어디 있지?"와 "이게 뭐지?"에 답합니다 — 파일명 globbing부터 정규식 내용 매칭, AST 패턴, 언어 서버 탐색까지.

find

glob으로 파일시스템 경로를 찾습니다. 선택 기준이 파일명·경로면 find, 파일 내용이면 search를 쓰세요.

• glob 문자가 없는 경로는 암묵적 **/*로 검색합니다. 최상위 단독 glob *.ts는 **/*.ts가 되며, src/*.ts는 src 아래 비재귀 세그먼트로 유지됩니다.
• 결과는 최근 수정순으로 정렬됩니다.
• .gitignore는 항상 적용됩니다. 끄는 플래그는 없습니다.
• 루트 /에서의 검색은 거부됩니다. 매치 없으면 No files found matching pattern.

search

파일, 디렉터리, glob, 내부 URL에 걸쳐 정규식으로 파일 내용을 검색합니다.

매치 줄은 *anchor|line, 컨텍스트 줄은 anchor|line입니다(해시라인: *5th|content, 일반: *5|content). 디렉터리 결과는 # <path> 제목 아래 파일별로 묶입니다. 기본 컨텍스트는 앞 1줄, 뒤 3줄.

search_tool_bm25

숨은 도구 발견 인덱스를 검색하고 상위 매치를 현재 세션에 활성화합니다. 파일 내용이 아니라 다른 도구를 찾습니다.

BM25로 발견 가능한 도구를 랭킹합니다. activateDiscoveredTools()로 매치를 활성화한 뒤 간결한 JSON 요약을 반환합니다:

{"query":"...","activated_tools":["..."],"match_count":2,"total_tools":17}

활성화된 도구는 같은 턴의 다음 모델 호출 전에 사용 가능해집니다. 이 도구는 tools.discoveryMode !== "off"일 때만 나타나며, "all" 모드에서 숨은 발견 가능 빌트인을 표면화할 수 있습니다(기본 read, bash, edit은 계속 활성).

ast-grep

네이티브 ast-grep로 지원 소스 파일에 구조적 코드 검색을 합니다.

패턴 문법:

메타변수 이름은 대문자여야 하고 전체 노드를 가리켜야 합니다. 같은 이름을 두 번 쓰면 매 등장마다 동일 코드를 요구합니다. 언어는 넓은 카탈로그에서 파일별로 추론됩니다(javascript, typescript, tsx, python, go, rust, java, c, cpp, ruby, php, json, yaml, html, css 등). 매치는 *LINE+HASH|text(해시라인) 또는 *LINE|text로 렌더되며 선택적 meta: NAME=value 줄이 붙습니다. 보이는 결과는 기본 50개입니다.

lsp

언어 서버에 진단, 탐색, 심볼, 이름 변경, 코드 액션, 능력, 원시 요청을 질의합니다.

주요 액션:

• diagnostics — 파일별·glob 진단; file: "*"는 워크스페이스 검사(cargo check, npx tsc --noEmit, go build ./..., pyright).
• definition / type_definition / implementation / references — 정의 이동·사용처 찾기, 주변 컨텍스트 포함.
• hover — 위치의 타입/시그니처 텍스트.
• symbols — 문서 심볼 또는 query에 맞는 워크스페이스 심볼.
• rename / rename_file — 심볼·파일 이름 변경(apply: false로 미리보기).
• code_actions — 퀵픽스 목록·적용; query는 목록 모드에선 필터, 적용 모드에선 선택(인덱스 또는 제목 부분 문자열).
• status / reload / capabilities / request — 서버 점검과 원시 JSON-RPC.

resolve

예약된 미리보기 동작을 적용하거나 버려 마무리합니다. 숨은 도구입니다. 다른 도구(예: ast-edit)가 미리보기를 예약하고 일회성 resolve 선택을 강제한 후에만 동작합니다.

apply는 생산자의 apply 콜백을, discard는 reject 콜백을 돌리거나 Discarded: <label>. Reason: <reason>을 냅니다. 대기 중 미리보기가 없으면 No pending action to resolve.로 오류.

무엇을 언제 쓸까