Community라이팅 & 에디팅github.com

DerrickZeng33/find-files-with-everything-cli

Codex, Claude Code 및 호환 AI 에이전트를 위한 빠른 Windows 파일 검색 도구로, Voidtools Everything CLI를 활용합니다.

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

이 스킬은 Windows 운영체제에서 Voidtools Everything의 명령줄 인터페이스 `es.exe`를 읽기 전용 클라이언트로 사용하여 파일 검색을 수행합니다. Everything 인덱스를 활용하기 때문에 기존의 파일 시스템 탐색 방식보다 훨씬 빠르게 컴퓨터 전체 또는 특정 경로에서 파일과 폴더를 찾을 수 있습니다. 이 스킬은 Codex, Claude Code, Cursor 등 다양한 AI 에이전트 플랫폼과 호환되며, 특히 파일 위치가 불확실하거나 작업 공간 외부에 있을 때 유용합니다. `es.exe`의 검색 옵션(경로, 확장자, 크기, 날짜 등)을 효율적으로 활용하고, 결과를 20개로 제한하여 불필요한 출력을 최소화하도록 설계되었습니다. 또한 상태 변경 명령어는 사용하지 않으며, 검색 결과에 대한 후속 작업(열기, 삭제 등)은 사용자가 명시적으로 요청할 때만 수행합니다.

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

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

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

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

문서

Find Files With Everything

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

검색 경로 지정

  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 상태 변경 옵션을 사용하지 마십시오. 사용자가 별도로 요청하지 않는 한 결과를 삭제, 이동, 복사 또는 열지 마십시오.

관련 스킬