명세 · CLI

CLI 명세

Native CLI

구문은 kfind [OPTIONS] QUERY [PATH]...입니다. 주요 컴파일 옵션으로 --pos, --expand, --boundary, --literal, --max-gap, --unicode-normalization을 제공합니다.

파일 옵션은 encoding, glob, type, ignore, thread와 context 출력을 제어합니다. 출력에는 --json, --explain-query, --explain-match와 --sort path를 사용할 수 있습니다.

kfind --pos verb --boundary smart 걷다 src
kfind --embedded --boundary any --json 'n:사용자 v:검증하다' src

npm CLI

Node.js 20 이상에서 @kfind/kfind의 kfind 명령을 사용합니다. --expand, --boundary, --pos, --normalization, --max-gap, --literal, --json을 지원합니다.

npx, pnpm dlx, Yarn 2 이상의 yarn dlx는 설치 없이 같은 명령을 실행합니다.

npx @kfind/kfind 걷다 README.md
pnpm dlx @kfind/kfind --pos verb 걷다 src
yarn dlx @kfind/kfind --json 권한 docs
npx @kfind/kfind 'v:걷다|n:사용자' src

기능 차이

npm CLI는 UTF-8 재귀 순회, stdin, 텍스트와 JSON Lines를 지원합니다. 패키지의 enriched predicate를 사용하고, 필요한 질의에서 compact component를 지연 로드합니다.

Full POS, Git ignore, EUC-KR, context, TUI, explain, 에이전트 통합 설치·제거에는 native CLI를 사용합니다.