Installation

System requirements

• Node.js 20+ or Bun v1.2+
• macOS or Linux (Windows not yet supported)

Zero install (recommended)

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

Docker

Prebuilt image (no build step):

docker run ghcr.io/var-ia/cli analyze "Earth" --depth brief

Or build from source:

git clone https://github.com/refract-org/refract.git
cd refract
docker build -t refract .
docker run --rm refract analyze "Earth" --depth brief

From source

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

Verify installation

refract --version