Installation

System requirements

Node.js 20+ or Bun v1.2+
macOS or Linux (Windows not yet supported)
Bun and a source checkout for SQLite persistence (--cache): it needs @refract-org/persistence, which uses bun:sqlite and is not published to npm. Analysis-only workflows work with Node.js.

Zero install

No download needed — runs directly from npm:

npx @refract-org/cli analyze "Earth" --depth brief

With bun (if installed):

bunx @refract-org/cli analyze "Earth" --depth brief

Local install

# with bun
bun add -g @refract-org/cli

# with npm
npm install -g @refract-org/cli

Then use the refract command directly (or wikihistory as an alias):

refract analyze "Earth" --depth brief

From source

git clone https://github.com/refract-org/refract.git
cd refract
bun install
bun run build
node packages/cli/dist/src/cli.js --version

Run the CLI as node packages/cli/dist/src/cli.js <command>, or put it on your PATH with bun link inside packages/cli.

Verify installation

refract --version

A version number means the CLI started; on 2026-09-29 npm's is 0.5.17. The CLI before it on npm, 0.5.7, does not start and fails here with SyntaxError: The requested module '@refract-org/analyzers' does not provide an export named …; npm install -g @refract-org/cli replaces it.