본문으로 건너뛰기
로그인 둘러보기
개발·코딩·데이터베이스 · 생산성·자동화 · 윈도우즈 유틸

atref

0

atref는 전역 파일 참조 피커로, 코드 입력을 통해 퍼지 방식으로 파일을 빠르게 찾아 선택하고, 선택한 파일의 경로를 현재 캐럿 위치에 바로 삽입하는 CLI 도구입니다.

생산성에이전트파일 선택기퍼지 검색

소개

atref는 전역 파일 참조 피커로, 코드 입력을 통해 퍼지 방식으로 파일을 빠르게 찾아 선택하고, 선택한 파일의 경로를 현재 캐럿 위치에 바로 삽입하는 CLI 도구입니다. Windows 시스템 트레이에서 실행되며, 어떤 텍스트 필드에서도 지정된 키 조합(기본값: Ctrl+Space)을 눌러 호출할 수 있습니다. 퍼지 검색 및 frecency 순위를 기반으로 파일을 필터링하고, 선택 시 `@""` 형태의 참조를 캐럿 위치에 삽입합니다.

상세정보

퍼지 파일 검색

입력한 키워드에 유사한 파일을 실시간으로 필터링하며, nucleo 매칭 알고리즘을 사용해 basename 가중치, 스마트 케이스, CamelHumps를 지원합니다. 최근 및 가장 많이 사용된 파일은 빈 쿼리 시 우선 표시되고, 동점 시 순위를 결정합니다.

경로 삽입

선택한 파일의 전체 경로를 `@””` 형식으로 편집기의 캐럿 위치에 자동 입력합니다. Enter 키로 선택을 확인하고, Esc 키로 검색 창을 닫을 수 있습니다.

멀티폴더 및 git 인식

여러 폴더를 인덱싱하고, .gitignore를 따라 무시된 파일은 건너뛰되 미추적 파일은 표시합니다. 실시간 파일 감시자를 통해 새로 추가되거나 변경된 파일을 감지합니다.

즉시 실행 및 지속성

on-disk redb 캐시를 통해 즉시 실행되며, 백그라운드에서 파일 시스템과 동기화됩니다. config.json 파일을 수정하면 재시작 없이 핫리로드가 적용됩니다.

에이전트용 설정 CLI

`atref describe` 명령으로 명령어 및 설정 스키마를 JSON 형태로 출력하여, 에이전트가 `atref config add folders …` 등을 통해 설정을 자동화할 수 있습니다. 설정은 검증되고 원자적으로 적용됩니다.

설치·시작·기본 사용법

WinGet을 통해 `winget install –id JuanjoFuchs.atref –exact` 명령으로 설치할 수 있습니다. 설치를 마친 후 `atref` 명령을 실행하면 시스템 트레이에 거주합니다. 텍스트 필드에서 Ctrl+Space를 누르면 퍼지 검색 창이 나타나며, 파일 이름 일부를 입력해 필터링하고 방향키로 선택 후 Enter를 눌러 경로를 삽입합니다.

지원 환경·요구사항

Windows 10/11 (x64)에서 실행되며, Microsoft Edge WebView2 런타임이 필요합니다. 이 런타임은 Windows 11에 사전 설치되어 있습니다.

버전·업데이트

현재 버전은 0.6.0입니다. 자세한 업데이트 내역은 공식 GitHub 저장소의 릴리스 페이지를 참조하시기 바랍니다.

시스템 요구사항

- Windows 10/11 (x64)
- Microsoft Edge WebView2 런타임 (Windows 11에 사전 설치됨)