CLI 참조

native CLI

구문은 kfind [OPTIONS] QUERY [PATH]...입니다. 주요 compile option은 --pos, --expand, --boundary, --literal, --max-gap, --unicode-normalization입니다.

파일 option은 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의 bin 이름 kfind를 사용합니다. --expand, --boundary, --pos, --normalization, --max-gap, --literal, --json을 지원합니다.

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

npx @kfind/kfind 걷다 README.md
pnpm dlx @kfind/kfind --pos verb 걷다 src
yarn dlx @kfind/kfind --json 권한 docs

기능 차이

npm CLI는 UTF-8 재귀 순회, stdin, text와 JSON Lines에 집중합니다. Package의 enriched predicate를 사용하고 필요한 query에서 compact component를 lazy load합니다.

Full POS, Git ignore, EUC-KR, context, TUI, explain과 agent skill 초기화는 native CLI를 사용합니다.