# Qurom Installation — OpenCode

> 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

Edit the OpenCode config file at `~/.opencode/config.json`.

If the file already has an `"mcp"` section with `"servers"`, add the `"qurom-mcp"` entry inside it. If there's no MCP section, add one.

The entry to add inside `"mcp" → "servers"`:

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

A complete example (if the file has no existing MCP config):

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

If the file already has other content (like provider configs), merge the `"mcp"` section into the existing JSON. Do not overwrite existing configuration.

## Step 3: Restart OpenCode

Tell the user:

> **Qurom is installed! Please restart OpenCode to activate the CEO.** Close your current session and start a new one. 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:
- Check `/status` in the OpenCode TUI — it should show "1 MCP" or more
- Verify the JSON is valid: `python -m json.tool ~/.opencode/config.json`
- Make sure `python -m qurom.server` runs without errors when executed manually