Installation

System requirements

Node.js 20+ or Bun v1.2+
macOS or Linux (Windows not yet supported)
Bun required for SQLite persistence (--cache). Analysis-only workflows work with Node.js.

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

# 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

git clone https://github.com/refract-org/refract.git
cd refract
bun install
bun run build

refract --version