Installation & first run

Install Cordy from the Chrome Web Store, grant optional access, and connect a model.

Cordy for Chrome installs from the Chrome Web Store, and Chrome updates it automatically. These steps take a few minutes the first time.

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.

Get Cordy

Cordy for Chromev2.5.7

Released 2026-10-19Release notes

Install from the Chrome Web Store

Install from the Chrome Web Store — it is the only supported way to install this extension, and it keeps itself updated.

Verification files for the published package:

PlatformArchitectureFileSizeSHA-256
Chrome—cordy-2.5.7-chrome.zip14.4 MB41ed36348a98

Full checksums are in SHASUMS256.txt on the release page.

The .zip is published so the package can be verified, not as an alternate way to install. Install from the Chrome Web Store.

Install only from the Chrome Web Store. Public builds come only from the Chrome Web Store; there are no supported source builds or side-loaded packages.

Each public release also publishes a .zip on the release page. That archive is there so the package can be verified, not as another way to install. A package loaded in Developer mode gets no automatic updates. A source tag (such as chrome-v2.5.7), a published release, and the version the Chrome Web Store serves are three separate facts. The version you actually run is the one the store installed; chrome://extensions shows it.

Install from the Chrome Web Store

  1. Open the Cordy listing in Chrome.
  2. Click Add to Chrome.
  3. Review the permission prompt and click Add extension.

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 no website access at install time — only a small set of always-on permissions (side panel, storage, tabs, and the machinery for tab management and search). 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 → Permissions, find In-Page Features, and click Enable, then approve Chrome's permission prompt. You can also start from the Unlock in-page AI features card in the side panel, or from the Grant website access button under Settings → General → Text Selection Menu. 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 with Revoke access on the same row. Turning it off stops Cordy running on pages; chat and other panel features are unaffected.

Optional permissions, requested on demand

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

  • Browsing history — when you first open the browsing-history view or @-mention history.
  • Bookmarks — when you first open the bookmark library or sync Chrome bookmarks.
  • Clear browsing data — when /clean or a chat tool first clears cache or cookies for a site.
  • Local AI runtimes — when you first connect to a runtime on localhost or 127.0.0.1.

Each is requested from a visible button, and each can be declined. Declining simply disables that feature until you grant it. Settings → Permissions lists every optional permission with its status (Granted or Not granted), so you can grant or revoke any of them later in one place.

Connect a model

The last step is telling Cordy which AI to use.

  1. Open the dashboard and go to Settings → AI Config → Provider Configuration.
  2. Choose a provider (OpenRouter, OpenAI, Anthropic, Google, xAI, Vercel AI Gateway, Volcengine Ark, DeepSeek, Qwen (Alibaba Cloud Model Studio), Groq, or Mistral AI), 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.

Updates

Chrome updates Cordy from the Chrome Web Store automatically. After an update, the side panel and the dashboard show an Updated to v… notice with View changes and Got it. The notice appears only after a real upgrade, not on a fresh install. You can read the notes for every version at any time from Release notes at the bottom of the dashboard sidebar; they are bundled with the extension and work offline.

Uninstalling

Right-click the Cordy icon and choose Remove from Chrome, or remove it from chrome://extensions. If you need your data later, first create a backup in Settings → Data Management → Backup Data or export your conversations. Backups do not include API keys.

Next steps