# Qurom Installation — Gemini CLI

> 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 by running:

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

## Step 2: Add the Qurom MCP Server

You need to register Qurom as an MCP server in Gemini CLI. Run this command:

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

If you are on the latest Gemini CLI (v2+), you can also add it to the settings file directly. The settings file is at:

- **Linux/macOS**: `~/.gemini/settings.json`
- **Windows**: `%APPDATA%\gemini\settings.json`

If the file exists, add this entry to the `mcpServers` object. If the file doesn't exist, create it with this content:

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

If there are already other MCP servers configured, add the `"qurom-mcp"` entry alongside them inside the existing `"mcpServers"` object. Do not overwrite existing servers.

## Step 3: Restart Gemini CLI

Tell the user:

> **Qurom is installed! Please restart Gemini CLI to activate the CEO.** Just close this terminal and open a new one, then start Gemini CLI again. 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 `gemini mcp add` fails:
- Make sure Gemini CLI is version 2.0 or later: `gemini --version`
- Try the manual settings.json approach instead

If `python -m qurom.server` fails:
- Check that qurom is installed in the same Python environment: `pip show qurom`
- Try using the full Python path: `which python` then use that path in the command

If the MCP server doesn't appear after restart:
- Run `gemini mcp list` to check if it's registered
- Check `~/.gemini/settings.json` for the correct entry