Chrome Extension Guide

Overview

The Markcat Chrome extension (MV3) provides a new tab page with your bookmark library and context menu capture for saving links.

Saving Bookmarks

• Context menu: Right-click any page or link → “Save to Markcat”.
• Extension icon: Click the Markcat icon in the toolbar to save the current page.
• Toolbar menu: Save every supported tab in the current window or across all windows.
• Bookmarks import: import your existing bookmarks (Netscape .html export) via the Import / Export dialog on the new tab page toolbar.

DOM HTML, screenshots, favicons, and Open Graph images are optional capture data. The extension omits any optional field that exceeds the service request limit and still saves the bookmark URL and title. An oversized URL remains a visible save failure rather than being truncated.

New Tab Page

The extension replaces your new tab with the Markcat dashboard:

• Category tree — left sidebar, expandable/collapsible hierarchy.
• Bookmark grid — cards showing title, favicon, OG image preview, and category.
• Search — full-text search across titles, URLs, and extracted content.
• Filters — filter by status (classified, pending, failed), category, or date.

Settings

Access via the gear icon on the new tab page:

• Connection — service URL, Local/Cloud mode, connection test.
• Theme — System (default, follows your OS), Daylight (light), Dusk, Midnight (dark).
• LLM provider — switch between Ollama, OpenRouter, OpenAI, Anthropic, or custom (local / self-hosted mode).
• Content, pipeline & worker — advanced extraction and processing options.
• Extension capture — choose whether extension-triggered saves attach DOM HTML, screenshots, favicons, and Open Graph images.

Managing Categories

Categories live in the left sidebar tree, not in Settings. Right-click a category to rename, move, or delete it. You can also create categories and drag bookmarks onto a category to re-categorize them.

Import / Export

Open the Import / Export dialog from the new tab page toolbar:

• Import — drop a Netscape .html bookmark export (Chrome/Firefox/Safari).
• Export — Netscape HTML (folders by classified category or original import hierarchy) or JSON (with optional extracted page content).

Onboarding

On first install, the extension walks you through:

1. Choosing Local or Cloud mode.
2. Entering and testing the service URL.
3. (Cloud) signing in or creating an account.

Provider and API-key configuration live in Settings once you’re connected.

Troubleshooting

• “Service not running” — start the local service with python -m service.main.
• Bookmarks stuck at “pending” — check that your LLM provider is configured and reachable (Settings → Test Connection).
• Slow classification — cloud LLMs (OpenRouter, OpenAI) are faster than local Ollama on modest hardware.