Installation

Quey has two parts: a Chrome extension that runs in your browser and a local MCP bridge that runs inside your project. Both must be running for the full workflow.

Requirements

Before you start, make sure you have:

  • Google Chrome (or any Chromium-based browser)
  • Node.js 18 or later
  • A project managed by npm, pnpm, or yarn
  • A compatible coding agent: Claude Code, Cursor, or OpenAI Codex

Chrome extension

  1. 1

    Open the Chrome Web Store

    Go to the Quey listing in the Chrome Web Store and click Add to Chrome.

  2. 2

    Pin the extension

    Click the puzzle-piece icon in the Chrome toolbar, find Quey, and click the pin icon so it stays visible.

  3. 3

    Sign in

    Click the Quey icon and sign in with your account to activate your plan. A free tier is available with no credit card required.

MCP bridge

The MCP bridge receives captures from the extension and exposes them to your coding agent. Install it once per project.

  1. 1

    Install the CLI

    npm install -g quey
# or
pnpm add -g quey
  2. 2

    Initialise in your project

    Run this from the root of the repo you want to edit with your agent:

    quey init

    This registers the Quey MCP server with your agent (Claude Code, Cursor, etc.) and creates a .quey/ config directory.

  3. 3

    Start the bridge

    quey bridge start

    Keep this running in a terminal while you work. The bridge listens on http://localhost:4747 by default.

Tip
You can start the bridge automatically by adding quey bridge start to your project's dev script. It exits cleanly when the terminal closes.

Verify the setup

Run the built-in diagnostic to confirm everything is connected:

quey doctor

A green checkmark next to each item means the extension, bridge, and agent are all talking to each other. If anything is red, the doctor output will tell you what to fix.

Note
For a guided first run — selecting your first element and sending a capture — see the Quickstart.