> ## Documentation Index
> Fetch the complete documentation index at: https://rapidreview.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Install Merv in your coding agent, sign in with the browser, and make your first call — about five minutes.

This is the hosted, interactive path — the default. Nothing to clone, no keys to copy. Not sure that's you? See [Choose your setup](/docs/merv/start/choose-your-setup).

<Steps>
  <Step title="Install the plugin in your agent">
    <Tabs>
      <Tab title="Claude Code">
        ```bash theme={"theme":{"light":"github-light","dark":"dark-plus"}}
        claude plugin marketplace add rapidreview-io/Merv
        claude plugin install merv@rapidreview
        claude mcp login plugin:merv:merv
        ```

        Enable automatic updates once under `/plugin` → **Marketplaces** → **RapidReview**.
      </Tab>

      <Tab title="Codex">
        ```bash theme={"theme":{"light":"github-light","dark":"dark-plus"}}
        codex plugin marketplace add rapidreview-io/Merv
        codex plugin add merv@rapidreview
        codex mcp login merv
        ```

        Update with `codex plugin marketplace upgrade rapidreview`, then `codex plugin add merv@rapidreview`.
      </Tab>

      <Tab title="Cursor">
        ```bash theme={"theme":{"light":"github-light","dark":"dark-plus"}}
        cursor-agent plugin marketplace add https://github.com/rapidreview-io/Merv
        cursor-agent
        ```

        In `/plugin`, install **merv** from **rapidreview**. Then select **Connect** for Merv in **Customize**. Team marketplaces can enable **Auto Refresh**.
      </Tab>

      <Tab title="Copilot CLI">
        ```bash theme={"theme":{"light":"github-light","dark":"dark-plus"}}
        copilot plugin marketplace add rapidreview-io/Merv
        copilot plugin install merv@rapidreview
        ```

        Start Copilot and run `/mcp auth merv`. Update with `copilot plugin update merv@rapidreview`.
      </Tab>

      <Tab title="Gemini CLI">
        ```bash theme={"theme":{"light":"github-light","dark":"dark-plus"}}
        gemini extensions install https://github.com/rapidreview-io/Merv --ref merv-client --auto-update
        ```

        Start Gemini and run `/mcp auth merv`. The extension updates automatically.
      </Tab>

      <Tab title="Qwen Code">
        ```bash theme={"theme":{"light":"github-light","dark":"dark-plus"}}
        qwen extensions install rapidreview-io/Merv --ref=merv-client
        ```

        Start Qwen, open `/mcp`, and sign in to Merv. Update with `qwen extensions update merv` when prompted.
      </Tab>

      <Tab title="OpenCode">
        ```bash theme={"theme":{"light":"github-light","dark":"dark-plus"}}
        opencode plugin 'github:rapidreview-io/Merv#merv-client' --global
        opencode mcp auth merv
        ```

        Skills update automatically when a session starts. Rerun the install command when Merv announces an adapter update.
      </Tab>

      <Tab title="Kilo Code">
        ```bash theme={"theme":{"light":"github-light","dark":"dark-plus"}}
        kilo plugin 'github:rapidreview-io/Merv#merv-client' --global
        kilo mcp auth merv
        ```

        Skills update when a new session starts; run `/reload` to update the current one.
      </Tab>

      <Tab title="Hermes Agent">
        ```bash theme={"theme":{"light":"github-light","dark":"dark-plus"}}
        hermes plugins install rapidreview-io/merv-hermes-client --enable
        hermes mcp add merv --url https://experiments.rapidreview.io/mcp --auth oauth
        ```

        Update with `hermes plugins update merv` when Merv announces an update.
      </Tab>
    </Tabs>

    Using OpenHands, Replit Agent, or another MCP client? See [Clients](/docs/merv/clients/overview).
  </Step>

  <Step title="Sign in when the browser opens">
    The plugin registers a URL only; the first 401 opens your browser. Sign in with your RapidReview account and approve **All my projects**. [How OAuth works](/docs/merv/clients/authentication)

    <Note>
      On a remote machine over SSH, connect with `ssh -L 19876:127.0.0.1:19876 user@host` first. The browser sign-in callback goes to `127.0.0.1:19876`, and the forward is what lets it reach the client running on the remote host.
    </Note>
  </Step>

  <Step title="Make the first call">
    Ask the agent to call `project(action="list")`, then `workflow.status_and_next(project_id)`. Follow along in the web UI at [rapidreview.io/merv](https://rapidreview.io/merv).
  </Step>

  <Step title="Check">
    <Check>The agent lists your project and reports `next_action`. Empty list? Create a project at [rapidreview.io/merv](https://rapidreview.io/merv) (or ask the agent for `project(action="create")`), or ask a member to add you.</Check>
  </Step>
</Steps>

## Next

<Columns cols={2}>
  <Card title="Your first experiment" icon="play" href="/docs/merv/start/first-experiment">
    Plan → design review → execute → results review, end to end.
  </Card>

  <Card title="Auto-run" icon="robot" href="/docs/merv/guides/auto-run">
    Pair a machine so experiments keep running without you.
  </Card>
</Columns>

Something off? [Troubleshooting setup](/docs/merv/start/troubleshooting).