# Qurom Installation — Claude Code

> 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 `.mcp.json` in the user's project root directory. This is the recommended approach for Claude Code.

If `.mcp.json` already exists, add the `"qurom-mcp"` entry to the existing `"mcpServers"` object. If it doesn't exist, create it with:

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

Alternatively, for a user-global installation (available in all projects), edit `~/.claude/settings.json` and add the same entry.

You can also use the Claude Code CLI:

```bash
claude mcp add qurom-mcp -- python -m qurom.server
```

## Step 3: Restart Claude Code

Tell the user:

> **Qurom is installed! Please restart Claude 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, 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 after restart:
- Check that `.mcp.json` is in the project root (same directory where you opened Claude Code)
- Run `claude mcp list` to verify registration
- Make sure `python -m qurom.server` works when run manually in the terminal