Installing AI Business OS

You install AI Business OS by pasting the prompt from your purchase email into Claude Code. Claude installs the workspace from git.genaiskills.io using the key in the prompt, then installs each PRIMA product you bought. You do not copy files or edit configuration by hand, and you do not need a GitHub account.

Before You Start

1. Install everything on the Requirements page.
2. Decide where the workspace will live on your computer. Choose a folder on your own disk, outside Dropbox, OneDrive, Google Drive and iCloud Drive.
3. Find your purchase email. Buying and Receiving Your Products explains what it contains.

Install From Your Purchase Email

1. Open VS Code.
2. Open the Claude Code panel.
3. Copy the whole prompt from your purchase email.
4. Paste it into the Claude Code panel and send it.
5. Tell Claude where to put the workspace if it asks, using the folder you chose.
6. Approve the steps Claude asks you to approve, and answer any questions it puts to you.
7. Restart Claude Code when Claude tells you to.
8. Open the workspace folder in VS Code if it is not already open.

Claude installs AI Business OS first, because every PRIMA product depends on it. It then adds PRIMA Project Management, PRIMA Memory and PRIMA CRM if you bought them.

Note

On Windows, run these steps in VS Code connected to WSL so that the workspace lives inside WSL, as the Requirements page explains.

What Gets Installed

Product	Where it goes
AI Business OS	The whole workspace, with .claude/ for commands, skills, rules and state, Domains/ for your work, Documentation/, Archive/, Infrastructure/Scripts/ and Scripts/
PRIMA Project Management	Its commands, skill, rules and dashboard files, copied into .claude/ and Scripts/
PRIMA Memory	The server in .claude/mcp-servers/prima-memory/, registered for this workspace, with its index folder .prima-memory/ kept out of git
PRIMA CRM	The server in .claude/mcp-servers/prima-crm/, registered for this workspace, with its database folder .prima-crm/

A new workspace also contains sample material, so you can see how the folders are meant to be used before you add your own work. There are three sample projects, P001 Website Redesign, P002 Q2 Marketing Campaign and P003 Staff Training Programme, and three sample client folders, Client-A, Client-B and Client-C, under Domains/01 Clients/. Your First Day explains how to archive them once you no longer need them. Folder Structure describes the full layout.

Check the Installation

1. In the Claude Code panel, type /. The list of commands includes /setup, /day, /night and /save.
2. Ask Claude which version of AI Business OS is installed. Claude reads it from .claude/engine-manifest.json, and a new installation reports 3.0.2.
3. If you bought PRIMA Memory or PRIMA CRM, type /mcp in the Claude Code panel. The list of servers shows prima-memory or prima-crm as connected.

You can also check the version yourself in a terminal opened in the workspace folder.

jq -r '.engineVersion' .claude/engine-manifest.json

3.0.2

If a server is missing or shows an error, see the installation page for that product, Installing PRIMA Memory or Installing PRIMA CRM.

When VS Code Suggests Extensions

The first time you open the workspace, VS Code offers to install the extensions the workspace recommends. Claude Code is the only one you need. You can decline OpenAI Codex, Ollama, Live Preview and Bearded Icons.

Developer Note: Installing From a Clone

Note

This route is for developers who want to inspect or test the repository by hand. It is not the supported install, and it installs AI Business OS only, without the PRIMA products.

Clone the repository from git.genaiskills.io with your key in place of <your-key>. The prompt in your purchase email contains the exact address.

git clone https://<your-key>:x@git.genaiskills.io/ai-business-os.git example-consulting-biz-os

Open the new folder in VS Code, then run /setup in the Claude Code panel.

Next Step

Run /setup next to personalise the workspace, and use Running Setup to follow each question as Claude asks it.