Community라이팅 & 에디팅github.com

DerrickZeng33/find-files-with-everything

Voidtools Everything CLI를 사용하여 Codex, Claude Code 및 호환 AI 에이전트를 위한 빠른 Windows 파일 검색을 제공합니다.

find-files-with-everything란 무엇인가요?

이 스킬은 AI 에이전트(Codex, Claude Code 등)가 Windows에서 Voidtools Everything의 `es.exe` CLI를 통해 거의 즉각적인 파일 검색을 수행할 수 있게 합니다. Everything이 실시간으로 유지하는 인덱스를 읽기 전용으로 활용하여, 위치를 모르거나 작업 공간 외부, 또는 인덱싱된 메타데이터(크기, 날짜, 확장자 등)를 기준으로 한 컴퓨터 전체 검색에 적합합니다. `rg`나 `Get-ChildItem`에 비해 수백 배 빠른 검색이 가능하지만, 에이전트가 불필요하게 많은 도구 호출을 하거나 방대한 텍스트를 반환하지 않도록 효율적인 쿼리 작성(예: 경로 한정, 파일/폴더 구분, 인덱싱된 검색어 사용)을 강조합니다. 또한 ES가 없거나 IPC 오류가 발생할 경우 좁은 범위의 대체 검색으로 자동 전환하며, `-reindex`나 `-exit` 등의 상태 변경 옵션은 사용하지 않습니다. 기본 결과 수는 20개로 제한되며, 쿼리를 세분화한 후에만 추가 결과를 요청합니다.

지원 대상✓Claude Code✓Codex CLI~Cursor
npx skills add DerrickZeng33/find-files-with-everything

Installed? Explore more 라이팅 & 에디팅 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

Find Files With Everything

es.exe를 실행 중인 Everything 인덱스에 대한 읽기 전용 클라이언트로 사용하세요. 도구 호출과 반환 텍스트를 최소화하세요.

검색 경로 설정

  1. 정확히 알려진 경로에는 Test-Path 또는 Get-Item을 사용하세요.
  2. 알려진 작업 공간 내의 파일명은 rg --files를, 알려진 트리 내의 콘텐츠는 rg를 사용하세요.
  3. 위치를 모르거나, 작업 공간 외부에 있거나, 컴퓨터 전체이거나, 인덱싱된 메타데이터를 기준으로 할 때는 먼저 Everything을 사용하세요.

효율적인 쿼리 실행

  1. 세션당 최대 한 번, 또는 실패한 쿼리 후에만 가용성을 확인하세요:

    Get-Command es.exe -ErrorAction SilentlyContinue
    

    그렇지 않으면 검색을 직접 실행하세요. ES가 없거나 IPC 오류 8을 반환하면 좁은 범위의 대체 검색을 사용하세요. 사용자가 요청하지 않는 한 소프트웨어를 설치, 시작 또는 수리하지 마세요.

  2. 출력을 늘리기 전에 쿼리를 좁히세요:

    es.exe -n 20 "report"
    es.exe -path "C:\Work" /a-d -n 20 "ext:xlsx"
    es.exe -size -dm -n 20 "size:>1gb"
    

    폴더에는 /ad, 파일에는 /a-d, 하위 트리에는 -path를 사용하고, ext:, size:, dm:, dc:와 같은 Everything 검색어를 사용하세요. 공백이 포함된 경로와 용어는 따옴표로 묶으세요.

  3. PowerShell 7 이상에서 호출할 때는 -argv를 먼저 넣으세요. Windows PowerShell 5.1 및 다른 셸에서는 생략하세요.

  4. 기본적으로 일반 경로를 반환하세요. 구조화된 메타데이터가 필요한 경우에만 -json과 추가 열을 사용하세요. 개수가 중요하거나 제한된 쿼리를 세분화해야 하는 경우에만 -get-result-count를 사용하세요.

  5. 기본 제한은 20으로 유지하세요. 제한에 도달하면 더 많은 결과를 요청하기 전에 쿼리를 세분화하세요. 요청하지 않는 한 결과를 파일로 내보내지 마세요.

결과 보고

  • 가장 작은 충분한 정확한 경로 집합을 반환하고 생략된 일치 항목을 요약하세요.
  • 결과가 없으면 쿼리 또는 범위를 명시하세요.
  • 결과가 0인 검색은 현재 Everything 인덱스에 대한 증거로 처리하고, 인덱싱되지 않은 위치가 비어 있다는 증거로 처리하지 마세요.
  • 알려진 프로젝트 트리에 대해 content:를 피하세요. 기본적으로 인덱싱되지 않으며 일반적으로 rg보다 효율성이 떨어집니다.

검색을 읽기 전용으로 유지

-exit, -reindex, -save-db, 실행 횟수 설정자, 저장된 설정 변경 등 ES의 상태 변경 옵션을 사용하지 마세요. 사용자가 별도로 요청하지 않는 한 결과를 삭제, 이동, 복사 또는 열지 마세요.

관련 스킬