# Qurom Installation — VS Code (GitHub Copilot)

> 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
```

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 `.vscode/mcp.json` in the user's project root.

**IMPORTANT**: VS Code uses `"servers"` as the key, NOT `"mcpServers"`. This is different from most other editors.

If `.vscode/mcp.json` already exists, add the `"qurom-mcp"` entry to the `"servers"` object. If it doesn't exist, create it:

```bash
mkdir -p .vscode
```

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

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

You can also add it via the command line:

```bash
code --add-mcp '{"name":"qurom-mcp","command":"python","args":["-m","qurom.server"]}'
```

## Step 3: Restart VS Code

Tell the user:

> **Qurom is installed! Please reload VS Code to activate the CEO.** Press `Cmd+Shift+P` (macOS) or `Ctrl+Shift+P` (Linux/Windows), type "Reload Window", and press Enter. When you're back, open Copilot Chat and say "Hello CEO" — I'll handle the rest.

## Step 4: First Conversation (after restart)

When the user returns, the Qurom MCP tools will be available. 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...

---

## Troubleshooting

- **Key is `"servers"` not `"mcpServers"`** — this is the most common mistake
- Must specify `"type": "stdio"` explicitly
- Reload window after any config changes
- Check MCP status via `Cmd+Shift+P` → "MCP: List Servers"