Bookmarks

An AI-assisted bookmark manager — folder, tag, grid, and domain views, two-way Chrome sync, import/export, AI tags, summaries, classification, and health checks.

Cordy turns Chrome's flat bookmark list into a workspace: browse by folder, tag, domain, or grid; let the AI tag, summarize, and classify your bookmarks; and clean out dead links, duplicates, and empty folders. It stays in sync with Chrome, so your real bookmarks are always the source of truth.

Overview

The bookmark manager lives in two places:

  • The side panel — a compact view (Folder / Tag / Grid) for quick browsing and drag-to-organize.
  • The dashboard → Bookmarks — the full workspace, with four tabs: Library, Sync, Health Check, and Insights.

Bookmarks are an optional feature: Cordy asks for Chrome's bookmarks permission the first time you use it. See Privacy & permissions.

Getting your bookmarks in

Grant access

The first time you open the manager, grant the bookmarks permission from the prompt. You can revoke it later; when revoked, the manager surfaces a clear "grant access" action rather than showing an empty list.

Sync from Chrome

In Bookmarks → Sync, pull your Chrome bookmarks into Cordy:

  • Full Sync imports everything (optionally clearing and re-importing, while preserving Cordy's own enrichment like AI tags and descriptions).
  • Incremental Sync applies just what changed — added, updated, or removed.

Cordy also runs a throttled incremental sync automatically when you open a bookmarks view, so it stays current without you thinking about it. A Sync History card shows the last several operations with added/updated/deleted counts.

Import from a file

Import bookmarks by dragging a file onto the Sync tab or using the file picker. Supported formats:

  • HTML — the standard Netscape bookmark file that every browser exports.
  • JSON — Cordy's own export format.

Browsing and organizing

Switch views to suit the task:

  • Folder / Tree — your folder hierarchy. In the dashboard this tree is fully editable: rename, create folders and subfolders, delete, and move (including drag-and-drop).
  • Tag — grouped by the tags on each bookmark.
  • Grid — a flat, favicon-forward card grid.
  • Domain (dashboard) — grouped by website.

You can sort by Title, Date Added, or URL, search across everything, and edit a bookmark's title, tags, and notes. Large collections switch to virtualized rendering so scrolling stays smooth.

How sync works (two-way)

Cordy keeps a local copy of your bookmarks but treats Chrome as the structural source of truth:

  • Structural edits you make in Cordy's tree (rename, new folder, delete, move) are written to Chrome first, then mirrored locally — so your browser's bookmark bar always matches.
  • Chrome → Cordy changes flow in via full and incremental sync.
  • If you delete a bookmark in Chrome, Cordy soft-deletes its copy (marked "orphaned" and hidden) while keeping any AI metadata, in case it returns.
  • AI-only fields (tags, categories, AI summaries) live only in Cordy's local database — Chrome's bookmark format has no place for them, so they're never written back.

AI features

Cordy's model can enrich your library. These use your configured models (bookmark classification has its own model slot).

AI tags

Generate AI Tags (Library tab) reads your bookmarks and assigns descriptive tags. It processes the currently loaded bookmarks in batches (roughly one model call per ten bookmarks), so narrow the list with search first if you only want a subset — a confirmation dialog tells you how many will be sent.

AI classification

Classify runs the bookmark-classification agent, which batch-organizes bookmarks into categories. It works in batches, classifies by domain first (no model call for well-known sites), and only falls back to AI for low-confidence or unknown domains — using a cloud model if you've configured one, or on-device Gemini Nano if you haven't. Progress streams live as it runs.

AI summaries

Generate Summaries (Insights tab) writes short descriptions for bookmarks that don't have one, in batches. Generated summaries are listed inline for review.

Health check

The Health Check tab finds and fixes bookmark rot with three independent scans:

  • Dead Link Detection — checks each bookmark's URL and flags dead, timeout, or error results (with the HTTP status). Progress is shown and the scan is abortable.
  • Duplicate Detection — groups bookmarks with the same normalized URL (case, trailing slash, and www. are ignored), so near-identical URLs are caught.
  • Empty Folder Detection — finds folders that hold no bookmarks, recursively (a folder counts as empty only if all its subfolders are empty too).

One-Click Cleanup opens a preview where you tick which categories to remove — dead links, duplicates, and/or empty folders — and confirm. Cordy reports how many bookmarks and folders it removed.

Export and backup

From Sync, export your library as JSON or HTML (downloaded as cordy-bookmarks-<timestamp>). The HTML export re-imports into any browser; the JSON export preserves Cordy's enrichment. Your whole library is also included in the app-wide backup under Settings → Data Management — see Privacy & permissions.

Privacy

  • Bookmark access is optional and requested at first use.
  • AI tagging, classification, and summaries send bookmark titles/URLs to the model you configured for those features — a cloud provider, or an on-device model that keeps everything local. Classification falls back to on-device Gemini Nano when no cloud key is set.
  • Dead-link checks make requests to the bookmarked sites themselves to see if they still load.