🎉 Launch Sale 80% off, lifetime access, no monthly fees
Thorim ← Back to home

Setup

How to install Thorim

Step-by-step for every platform. Pick yours below.

Before you start

  • You should have received an install command in your welcome email. It looks like curl -fsSL https://install.thorim.io/<long-token> | bash. That long token is unique to you.
  • Lost the email? Recover the install command at thorim.io/resend-install.
  • You'll need Node.js 20+. If you don't have it, the installer offers to set it up for you with one prompt. No admin password required on Windows.
  • An AI coding tool already on your machine: Claude Code, Cursor, Windsurf, Codex CLI, or Gemini CLI. Thorim plugs into whichever ones it finds.

Pick your platform

1Open Terminal

Press ⌘ + Space, type Terminal, hit Enter. (Alternatively, Applications → Utilities → Terminal.)

2Paste your install command and press Enter

From your welcome email:

curl -fsSL https://install.thorim.io/<your-token> | bash

3Watch the installer run

You'll see this in your terminal:

Thorim installer ──────────────────── Install 1 of 10 for this license Link valid until 2026-08-09 Downloading Thorim... done Extracting... done ▲ THORIM v0.1.0 Give your AI coder a co-founder. License verified. Detected. Detection ────────────────────────────────╮ Where you are: ✓ Local machine (your-mac-name) ✓ macOS 14.4.0 AI coders found: ✓ Claude Code /Users/you/.claude Set up Thorim for Claude Code? [Y/n]

4Press Y at each prompt

You'll see a single Plan card showing exactly what's about to happen (refresh existing tools, install for new ones, what gets backed up where). Press Y to continue, the install runs for ~15 seconds.

5Look for "Welcome to Thorim"

✓ The spine ✓ Memory architecture ✓ 20 specialists ✓ 106 skills (across 13 categories) ✓ 14 commands ✓ 6 hooks ✓ Settings merge ✓ Verified Claude Code: 11/11 checks passed ▲ Thorim is installed. Open your AI coder on any project. Type /hellothorim. Welcome to Thorim.

Important: if your Claude Code chat was open while you installed, close it and open a new chat. New commands like /hellothorim and /doctor only appear in chats opened after the install.

1Open your terminal

Any terminal that runs bash works: GNOME Terminal, Konsole, xterm, Alacritty, etc.

2Paste your install command and press Enter

curl -fsSL https://install.thorim.io/<your-token> | bash

3Watch the installer run

Same flow as macOS. The Detection card shows your Linux details:

Detection ────────────────────────────────╮ Where you are: ✓ Local machine (your-hostname) ✓ Linux 6.8.0-generic AI coders found: ✓ Claude Code /home/you/.claude

4If Node isn't installed

You'll see this prompt. Press Y:

⚠ Node.js 20+ is required but is not installed. Thorim can install Node 20 for you using fnm (a clean, fast Node version manager, no sudo needed, no .bashrc pollution beyond a single line). Install Node 20 via fnm now? [Y/n]

fnm installs Node into your home directory, no sudo or system changes. Takes ~20 seconds.

5Press Y through the rest

Plan card, single confirm, install completes, you see Welcome to Thorim.

Important: close and reopen any Claude Code or Cursor chat that was open during install. The new /hellothorim command only appears in fresh chat sessions.

Use PowerShell, not Command Prompt. The Thorim installer is a script that runs in PowerShell (or Git Bash / WSL). Plain cmd.exe doesn't have the commands it needs.

1Open PowerShell

Press the Windows key, type PowerShell, click the PowerShell app (not "Command Prompt"). A blue prompt opens:

PS C:\Users\You> _

2Paste your install command

Use the PowerShell version from your welcome email (note the .ps1 in the URL and the different shell syntax):

iwr -useb https://install.thorim.io/<your-token>.ps1 | iex

Press Enter. The installer runs in the same window.

3If Node isn't installed

Press Y at this prompt:

⚠ Node.js 20+ is required but is not installed. Thorim can install Node 20 for you from nodejs.org (ZIP archive, no admin needed, installed to your user account only). Install Node 20 now? [Y/n]

Node lands in %LOCALAPPDATA%\thorim\node\. No Windows admin prompt. Takes ~20 seconds.

4Press Y through the rest

The PowerShell window stays open throughout. You'll see the Plan card, then a single confirm, then the install runs.

5"Welcome to Thorim"

Once you see it, you're done. Open or restart your AI coder (Claude Code, Cursor, etc) and type /hellothorim.

If you'd rather use WSL or Git Bash: you can use the bash version of the command (curl -fsSL ... | bash) instead. Same outcome, just a different shell.

1SSH into your VPS

From your local terminal or VS Code:

ssh root@your-vps-ip

You're now in your VPS's shell. The install command runs there, not on your laptop.

2Paste your install command

curl -fsSL https://install.thorim.io/<your-token> | bash

3About installing as root

Most VPS setups run as root by default. The installer prints a yellow warning and continues:

⚠ You're installing as root. That's fine on a single-user VPS, but if this is a shared machine you probably want to run as your normal user.

If your VPS is truly single-user (just you), ignore the warning. If you share it with teammates, run as your own user account instead.

4Same flow as the other platforms

Detection → Plan card → confirm → install → "Welcome to Thorim". The whole thing takes ~30 seconds (slightly longer than local because the package downloads from Cloudflare).

Each VPS needs its own install. If you have multiple VPSes you SSH into, run the install on each one separately. Thorim doesn't sync across machines; it's files on the machine you ran the command on.

Verify it worked

Open your AI coder, start a fresh chat, and type:

/doctor

You should see 4 environment checks and 11 install checks, all green:

Environment checks: ✓ home_set ─ $HOME resolves to /Users/you ✓ target_writable ─ /Users/you/.claude is writable ✓ disk_space ─ ~512000 MB free where Thorim will install ✓ install_host ─ install.thorim.io reachable Claude Code (/Users/you/.claude) ✓ manifest_present ✓ version_present ✓ settings_valid_json ✓ spine_present ✓ commands_populated (14+) ✓ agents_populated (20+) ✓ skills_populated (13+ categories) ✓ hooks_populated (6+ scripts) ✓ hooks_shebang_present ✓ manifest_files_landed ✓ manifest_dirs_landed All good. Thorim is healthy.

What to do next

You're set. Open a project folder in your AI coder, start a chat, type /hellothorim. Thorim will scan the project, build memory, and pick up where the project last left off.

For the full mental model (where files live, two-tier memory, updating, uninstalling, common issues): see Using Thorim.

If something looks wrong

The installer exited with an error

Re-read the error line. It includes a suggested fix. If the customer's previous setup was preserved (it almost always is), you'll see a line like:

Your previous setup is preserved at /Users/you/.claude.thorim-prev. Re-run the install command to retry, or restore manually from that backup.

Re-running the install is safe. Thorim is self-healing: every run gets you to the latest working state regardless of what state you were in beforehand.

/hellothorim doesn't appear in my AI coder

Your chat was open before the install ran, so its command list is stale. Close every chat, open a new one, the new commands will be there.

I'm on Windows and PowerShell closes immediately

You're likely running it via "Run with PowerShell" from a context menu instead of inside an open PowerShell window. Open PowerShell first (Start menu → "PowerShell"), then paste the command inside.

Install hangs at "Downloading Thorim"

Network issue between you and Cloudflare. Check your internet connection. If you're on a corporate or restricted network, install.thorim.io might be blocked. Try from a different network or contact your network admin.

Something else

Email thorimapp@gmail.com with the output of /doctor (or curl -fsSL ... | bash -s -- --doctor). Reply hours: Monday to Friday, 9am to 5pm. Outside those hours we'll get back to you the next working day.