dVersum Companion

The dVersum Companion browser extension turns any tab into a quick capture surface for your projects. Instead of copying, switching to dVersum, picking a project, and creating a task, you click once with the extension and the content lands as a task in the column you chose.

What it does

• Element picker — hover the page, click any element (text block, code snippet, image, list, whole section). Tab expands the selection to the parent element, Esc cancels.
• Save whole page — grabs the title, meta description, and URL as a task.
• Save selection — uses whatever text you already highlighted.
• Vero summarise — compresses long captures into a concise note. Uses your BYOK key (or the system key as fallback).
• Quick Inbox — an auto-generated catch-all project per user. Hit Save to Quick Inbox to skip the project/column picker entirely.

Installation

1. Clone or download the repo, navigate to chrome-extension/.
2. In Chrome, open chrome://extensions/ and toggle Developer mode (top right).
3. Click Load unpacked → pick the chrome-extension/ folder.
4. Pin the toolbar icon.

First connection

The extension reads your dVersum login from the browser cookie — there's no API key, no webhook to paste any more.

1. Make sure you're signed in to https://app.dversum.com in the same browser.
2. Open the Companion popup. Status reads "Connected as <your name>".
3. If it shows "Not connected", click Open dVersum, sign in, then re-open the popup.

Workflow

1. On any webpage, press ⌥⇧D (macOS) or Alt+Shift+D (Windows/Linux) — or click the toolbar icon → Capture from this page. Note: Chrome reserves ⌘⇧D on Mac for "Bookmark all open tabs" and won't let extensions claim that combo. You can change the shortcut at chrome://extensions/shortcuts.
2. The picker appears. Hover over an element, click — or use the two buttons in the top bar (Save whole page / Save selection).
3. The save card opens in the bottom-right with:
   • Title (pre-filled)
   • Description (the source URL is appended automatically)
   • ✦ Summarise with Vero (optional)
   • Project + column picker (smart-defaults to an "Inbox/Todo/Backlog" column if one exists)
4. Save task stores it to the chosen project; Save to Quick Inbox skips the picker.

Quick Inbox

The first time you click Save to Quick Inbox, a personal project called "Quick Inbox" is created with a single "Inbox" column. The project is pinned to the top of your personal area (sort_order = -1). You can move tasks out of it into "real" projects whenever you want.

Captured-from chip

Every task created by Companion stores its source URL. The task detail view shows a small "Captured from <hostname>" link above the description — click it to re-open the original page in a new tab.

FAQ

What happened to the old webhook + token? Dropped in v3.0. The extension now uses the auth_token cookie. If you previously pointed at a custom host, re-set it under "Settings" in the popup.

Does it work in local dev? Yes — set the URL in popup Settings to http://localhost:3000. The extension automatically routes API calls to :8080.

What about sites with strict CSP (banking, GitHub)? The picker injects CSS via chrome.scripting.insertCSS, which bypasses page CSP — should work everywhere. File an issue if not.

Does it grab images? No, only the image URL. We don't store the actual image data when the source is an external file.

Does Companion track my browsing history? No. Nothing happens until you trigger the picker and click. No background scraping, no telemetry.