Install

Run it with npx. You need Node 22.15 or newer, and you don’t need Bun:

npx friskme

To install the friskme command, run npm i -g friskme.

The npm package is one JavaScript file of about 1 MB, with no dependencies and nothing to compile. npm downloads it at install time; friskme itself downloads nothing. It’s tested on macOS and Linux. It should also run on Windows and on Alpine and other musl-based Linux distributions, but those aren’t tested. On Windows, the analyzer must be a native claude.exe, codex.exe or pi.exe, not an npm .cmd shim. --pii-model works only on macOS (Apple silicon or Intel) and Linux x64.

If you don’t have Node, download a standalone binary (about 70–90 MB) from GitHub Releases and put it on your PATH. Each release includes a SHA256SUMS file.

chmod +x frisk-darwin-arm64 && mv frisk-darwin-arm64 /usr/local/bin/friskme

To build from this repo, run bun run build:release. That writes all four binaries to dist/; build compiles only your own platform, and build:npm writes the Node bundle to dist/frisk.js.

Naming intents and drafting skills needs one model CLI, logged in: claude (Claude Code), codex or pi. friskme uses claude or codex, whichever you have, Claude first; --analyzer picks one. pi is used only with --analyzer pi, because its default model is whatever you chat with, which can cost far more per call than a small labeling model. Without either, run friskme --no-llm to get the overview and waste sections only.