PKC Setup
Ripgrep is an accelerator, not a dependency. Search and pack full-scan when rg is missing. Never install packages from a hook.
Process
- Detect:
python3 "${CLAUDE_PLUGIN_ROOT}/scripts/pkc_setup.py" --check python3 "${CLAUDE_PLUGIN_ROOT}/scripts/pkc_doctor.py" --repo . --json - If
rgis found, stop. Report the path. - If
rgis missing, show the user the platform command and wait for consent:- macOS:
brew install ripgrep - Debian/Ubuntu:
sudo apt-get install -y ripgrep - Fedora:
sudo dnf install -y ripgrep - Windows:
winget install BurntSushi.ripgrep.MSVC - any (Rust):
cargo install ripgrep
- macOS:
- Only after the user agrees, run:
Withoutpython3 "${CLAUDE_PLUGIN_ROOT}/scripts/pkc_setup.py" --install-rg --yes--yesthe script prints the command and exits 2. - Override path with
PKC_RG_PATH/OKF_RG_PATHif rg is installed off PATH.
Never
- Do not run
--install-rg --yesfromSessionStart,PostToolUse, or any other hook. - Do not
pip installanything. PKC stays zero-dep;rgon PATH is the only extra. - Do not install Ruby, and do not add a Ruby implementation.
Done when
- Toolchain report shown
- rg found, or user declined install and knows the full-scan fallback still works