AGENTS · SKILL

Skill installation

You can invoke the native CLI without installing an integration. Use --init to add session instructions and a pre-execution hook to a project. The npm CLI does not support this option.

Installation location

Select the agent from the project root. Repeat --agent for multiple agents, or omit it to select agents in an interactive terminal.

kfind --init --agent codex

The installer also registers project hooks for each selected agent. It preserves existing settings and does not overwrite skills without kfind ownership markers.

Invocation

Trusted integration hooks instruct the agent to use kfind for Korean lemma and inflection searches. The pre-execution hook blocks Korean patterns in rg, grep, and git grep unless fixed-string mode is explicit.

For exact error messages or surface forms, rg -F, grep -F, git grep -F, --fixed-strings, and fgrep are allowed. You can also use kfind --literal or IDE fixed-string search. Regular expressions are outside this exception.

kfind --embedded --boundary any --pos verb --json 걷다 src
kfind --uninstall --agent codex

Read the source around each span to check its meaning. Follow results and diagnostics to distinguish execution failures from no matches. Do not hide a resource error by automatically switching to any.

Maintenance

After upgrading the CLI, run --init again for the same agents to update managed skills and hooks. --uninstall removes only kfind-managed entries for those agents and preserves other skills and settings.