Download
Install Cliff
One file, cliff.mjs, version 0.2.0, 101 KB, MIT. It runs on Node.js 18 or later on macOS, Linux and Windows.
macOS and Linux
Paste this in a terminal. It checks for Node, downloads cliff.mjs, checks its SHA-256 against version.json, saves it in ~/.cliff/bin and adds a cliff command to ~/.local/bin. No root.
curl -fsSL https://readcliff.xyz/install.sh | sh
Rather read it first? It's short: install.sh. No Node yet? On macOS: brew install node. On Linux, your package manager or nodejs.org.
Then set it up
cliff setup # pick Anthropic, OpenAI, Gemini or an OpenAI-compatible endpoint (a local model too), paste the key cliff # start in any folder cliff doctor # check Node, keys, the chain connection and updates
Already have a key in your environment (ANTHROPIC_API_KEY, OPENAI_API_KEY or GEMINI_API_KEY)? Then skip setup and just run cliff.
Windows
With WSL, use the macOS and Linux command above inside WSL. Without it, install Node from nodejs.org, then in PowerShell:
mkdir $HOME\.cliff\bin -Force irm https://readcliff.xyz/cliff.mjs -OutFile $HOME\.cliff\bin\cliff.mjs (Get-FileHash $HOME\.cliff\bin\cliff.mjs -Algorithm SHA256).Hash # compare with version.json node $HOME\.cliff\bin\cliff.mjs setup
Honest note: we test Cliff on macOS and Linux. On plain Windows, shell commands run through cmd.exe and file permissions on ~/.cliff are Windows' own, so keep your user account private.
Direct download and checksum
| File | cliff.mjs |
|---|---|
| Version | 0.2.0 |
| Size | 103,192 bytes |
| SHA-256 | 35e76c9b791b3adb802f2a8c3335c91d9cc78585f9fbde04bffdaf9488d61d4c |
| Needs | Node.js 18 or later. No other dependencies. |
| License | MIT, in the file's header |
Check it yourself: shasum -a 256 cliff.mjs (macOS) or sha256sum cliff.mjs (Linux). cliff update fetches the newest file and refuses it unless the SHA-256 matches.
Desktop and phone apps
macOS app
Not built. The terminal agent is the product today.
Coming laterWindows app
Not built.
Coming lateriPhone and Android
Not built.
Coming laterUpdate and remove
cliff update # newest version, checked against its SHA-256 rm -rf ~/.cliff/bin ~/.local/bin/cliff # remove the program; settings, sessions and wallet stay rm -rf ~/.cliff # remove everything, including the wallet file: export the key first