# Qurom Installation — Cursor

> You are an AI agent helping a user install Qurom. Follow these steps exactly. Do not skip steps. After each step, confirm success before proceeding.

## Step 1: Install Qurom

Run this command:

```bash
pip install qurom
```

If pip is not available, try `pip3 install qurom` or `python -m pip install qurom`.

Confirm the install succeeded:

```bash
python -c "import qurom; print(f'Qurom {qurom.__version__} installed successfully')"
```

## Step 2: Add the Qurom MCP Server

Create or edit the file `.cursor/mcp.json` in the user's project root directory.

If `.cursor/mcp.json` already exists, add the `"qurom-mcp"` entry to the existing `"mcpServers"` object. If the file or directory doesn't exist, create them:

```bash
mkdir -p .cursor
```

Then write this to `.cursor/mcp.json`:

```json
{
  "mcpServers": {
    "qurom-mcp": {
      "command": "python",
      "args": ["-m", "qurom.server"]
    }
  }
}
```

For a user-global installation (available in all projects), edit `~/.cursor/mcp.json` instead.

## Step 3: Restart Cursor

Tell the user:

> **Qurom is installed! Please restart Cursor to activate the CEO.** Press `Cmd+Shift+P` (macOS) or `Ctrl+Shift+P` (Linux/Windows), type "Reload Window", and press Enter. You can verify the MCP server is active by going to Settings → Cursor Settings → Tools & MCP — look for a green dot next to "qurom-mcp". When you're back, say "Hello CEO" and I'll handle the rest.

## Step 4: First Conversation (after restart)

When the user returns after restarting, the Qurom MCP tools will be available. Start by running the `detect_environment` tool to auto-detect installed AI providers, then run `setup_company` to create the initial configuration.

Welcome the user with:

> Welcome to Qurom. I'm your CEO — I coordinate AI agents to get work done for you. Let me scan your system to see what AI tools you have installed...

Then proceed to detect providers and configure the company.

---

## Troubleshooting

If the MCP server doesn't appear:
- Go to Settings → Cursor Settings → Tools & MCP to check server status
- A green dot means active, yellow means needs attention
- Make sure `.cursor/mcp.json` is valid JSON (no trailing commas, no comments)
- Try reloading the window: `Ctrl+Shift+P` → "Reload Window"