Installation & first run

Install the published 2.4.4 archive or a 2.4.5 source build, grant optional access, and connect a model.

Cordy for Chrome is installed as an unpacked extension. The latest published GitHub Release is 2.4.4; source and the repository tag are at 2.4.5, which has no published Release. The repository and its releases require repository access.

Requirements

  • Google Chrome 148 or newer. That is the manifest minimum. Check at chrome://settings/help.
  • A provider API key if you want to use a cloud model — or nothing at all if you plan to run local, on-device models.
  • Roughly 30 MB of disk space for the unpacked extension.

Get the build

You'll receive Cordy in one of two forms:

  • A folder containing a manifest.json (an already-unpacked build), or
  • The published cordy-2.4.4-chrome.zip release asset — unzip it into a folder you will keep. The release also contains checksums-2.4.4.txt for integrity checking.

For source 2.4.5, run the repository build and load .output/chrome-mv3. A source tag does not make a published binary release.

Load it into Chrome

  1. Open chrome://extensions (type it into the address bar, or go to ⋮ menu → Extensions → Manage extensions).
  2. Turn on Developer mode with the toggle in the top-right corner.
  3. Click Load unpacked.
  4. Select the folder that contains manifest.json (the unzipped folder, or .output/chrome-mv3).
  5. Cordy appears in your extensions list as Cordy — AI Assistant & Tools.

If Chrome reports that the browser version is too old, update to Chrome 148 or later and retry.

No "read all your data" warning

You'll notice the install prompt is unusually quiet: there is no "read and change all your data on all websites" warning. That's deliberate. Cordy requests only a small set of always-on permissions at install time (side panel, storage, tabs, and the machinery for tab management). Access to page content, history, and bookmarks is optional and requested later, from a button you click — never silently at install. See Privacy & permissions for the full breakdown.

Pin Cordy to the toolbar

  1. Click the Extensions puzzle-piece icon in the Chrome toolbar.
  2. Find Cordy in the list and click the pin icon next to it.

The Cordy icon now stays visible. Clicking it toggles the side panel.

Open the side panel

Click the pinned Cordy icon, or use the shortcut:

PlatformShortcut
Windows / LinuxCtrl + Shift + Y
macOSCmd + Shift + Y

The side panel docks to the right of the current window. You can also open Cordy as a full browser tab from the side panel header if you want more room.

Grant site access (first use)

Chat and most panel features work immediately. But the in-page features need permission to run on the websites you visit. This covers:

  • the floating text-selection menu (translate / explain / summarize / read aloud),
  • in-page translate, explain, and summarize results,
  • page read-aloud,
  • the on-page command palette, and
  • reading the current page's content into chat.

To enable them, open Settings → General → In-Page Features and click Enable, then approve Chrome's permission prompt. (You can also trigger this from the "Unlock in-page AI features" card that appears in the side panel.) Once granted, Cordy registers its in-page script and the features light up immediately — no page reload needed.

You can revoke this access at any time from the same setting. Turning it off stops Cordy running on pages; chat and other panel features are unaffected.

After an upgrade: because site access is an optional, per-install grant, a major upgrade can reset it. If in-page features stop working after Cordy updates, re-enable them once in Settings → General → In-Page Features.

Optional permissions, requested on demand

A few features ask for their own Chrome permission the first time you use them, and not before:

  • History — when you first open the browsing-history view or @-mention history.
  • Bookmarks — when you first open the bookmark library or sync Chrome bookmarks.
  • Site-data cleanup — when the AI or command palette first clears cache/cookies for a site.

Each is requested from a visible button, and each can be declined. Declining simply disables that feature until you grant it.

Connect a model

The last step is telling Cordy which AI to use.

  1. Open the dashboard and go to Settings → AI Config → Providers.
  2. Choose a provider (OpenRouter, OpenAI, Anthropic, Google AI, xAI, Vercel AI Gateway, or Volcengine Ark), and paste in your own API key. Optionally set a custom Base URL, or add a custom OpenAI-compatible provider.
  3. Switch to AI Config → Feature Models and pick a Chat model.

Full details, including where to get each provider's key, are on Providers & models. To skip cloud providers entirely, set up local, on-device AI instead.

The first cloud message triggers a one-time privacy consent dialog — accept it once to continue.

Customize keyboard shortcuts

Cordy's global shortcuts (toggle side panel, open command palette, collect tabs, open the extension menu) are managed by Chrome. To change them, open chrome://extensions/shortcuts, or use Settings → Shortcuts → Customize in Chrome. See the FAQ for the full shortcut list.

Uninstalling

Right-click the Cordy icon and choose Remove from Chrome, or remove it from chrome://extensions. Export conversations first if you need them later. Data Management cleanup and backup preserve the bookmark library; deleting provider keys is a separate action.

Next steps