Install Rook
Getting set up is a one-time thing. Afterwards, you just talk to your assistant.
What you’ll need
Section titled “What you’ll need”- Windows with Rhino 8
- An AI assistant that supports MCP — Claude Code (CLI, desktop, or VS Code extension), Codex, or another MCP-capable client (Cursor, Windsurf)
- An account or API key for the AI model you want to use (Claude, GPT, or a local model via Ollama / LM Studio)
You do not need to install Python. The Rook installer includes and configures the local runtime it needs.
You don’t need to be a programmer, and you don’t need to know any Rhino commands.
Step 1 — Install Rook (the Rhino plug-in)
Section titled “Step 1 — Install Rook (the Rhino plug-in)”-
Download the installer directly — Rook-Setup-1.5.13.exe — or open the v1.5.13 release page for the SHA-256 checksum and the FFmpeg source bundle. You can always grab the newest build from the latest release.
-
Run it. The installer adds Rook to Rhino and Grasshopper and sets up the local MCP server.
-
Start (or restart) Rhino. Rook loads automatically.
Step 2 — Connect your assistant
Section titled “Step 2 — Connect your assistant”Rook talks to your AI assistant through MCP — the doorway that lets your assistant reach into Rhino. You point your assistant at Rook once.
-
Open your assistant’s settings and find where it lists MCP servers.
-
Add Rook (the installer registers it for Claude Code, Claude Desktop, and Codex automatically; you mostly just enable it).
-
Tell your assistant which AI model and key to use, if it asks.
See Claude Code & Desktop and Codex & Other Clients for per-client details.
Step 3 — Add the Rook plugin (Claude Code)
Section titled “Step 3 — Add the Rook plugin (Claude Code)”To get the / skills and the session hook in Claude Code, add the marketplace plugin:
/plugin marketplace add bringfire/rook-release/plugin install rook@rookThis provides the / skills + the session hook for Claude Code.
Codex users: the curated skills are installed for you by the installer — no extra step.
Step 4 — Verify
Section titled “Step 4 — Verify”Hand your agent the Post-Install Agent Setup page. It is the recommended end-to-end verification prompt after a fresh installer run.
For a shorter explanation of what each check means, see Set Up & Verify.
→ Next: Your First Conversation