dVersum Companion

Die dVersum Companion Browser-Extension verwandelt jeden Tab in einen Speicherort für deine Projekte. Statt etwas zu kopieren, dVersum zu öffnen, ein Projekt zu wählen und eine Aufgabe anzulegen, klickst du mit der Extension einmal — und der Inhalt landet als Aufgabe in der von dir gewählten Spalte.

Was du tun kannst

• Element-Picker — fahre mit der Maus über die Seite, klicke ein beliebiges Element (Textblock, Codeausschnitt, Bild, Liste, ganze Sektion) an. Tab vergrößert die Auswahl auf das Eltern-Element, Esc bricht ab.
• Ganze Seite speichern — speichert Titel, Meta-Beschreibung und URL als Aufgabe.
• Markierten Text speichern — wenn du Text im Browser bereits markiert hast.
• Vero-Zusammenfassung — verdichtet längere Captures auf eine kurze Notiz. Nutzt deinen BYOK-Schlüssel (oder den System-Schlüssel als Fallback).
• Quick Inbox — ein automatisch erzeugtes "Catch-all"-Projekt pro Nutzer. Mit dem Save to Quick Inbox-Button überspringst du die Projekt-/Spaltenwahl komplett.

Installation

1. Klone oder lade das Repository, navigiere zu chrome-extension/.
2. In Chrome: chrome://extensions/ → Entwicklermodus aktivieren (oben rechts).
3. Entpackte Erweiterung laden → den Ordner chrome-extension/ wählen.
4. Pinne das Icon in der Toolbar.

Erste Verbindung

Die Extension liest deinen Login direkt aus dem Browser-Cookie — du musst keinen API-Schlüssel und keinen Webhook mehr eingeben.

1. Stelle sicher, dass du in https://app.dversum.com im gleichen Browser eingeloggt bist.
2. Öffne das Companion-Popup. Status zeigt "Connected as <dein Name>".
3. Falls "Not connected" angezeigt wird, klicke auf Open dVersum, logge dich ein, öffne das Popup erneut.

Workflow

1. Auf einer beliebigen Webseite: Tastenkombination ⌥⇧D (macOS) bzw. Alt+Umschalt+D (Windows/Linux) — oder Toolbar-Icon → Capture from this page. Hinweis: Chrome reserviert ⌘⇧D auf dem Mac für "Alle Tabs als Lesezeichen speichern" und lässt Erweiterungen diese Kombination nicht beanspruchen. Du kannst die Tastenkombination unter chrome://extensions/shortcuts ändern.
2. Picker erscheint. Hover über ein Element → klick — oder benutze einen der beiden Buttons oben (Save whole page / Save selection).
3. Das Speicher-Fenster (unten rechts) öffnet sich mit:
   • Titel (vorausgefüllt)
   • Beschreibung (Quell-URL wird automatisch angehängt)
   • ✦ Summarise with Vero (optional)
   • Projekt-/Spaltenauswahl (smart-default auf "Inbox/Todo/Backlog"-Spalten falls vorhanden)
4. Save task speichert in das gewählte Projekt, Save to Quick Inbox überspringt die Auswahl.

Quick Inbox

Beim ersten Klick auf Save to Quick Inbox wird ein persönliches Projekt namens "Quick Inbox" mit einer einzigen Spalte ("Inbox") angelegt. Das Projekt wird in deinem persönlichen Bereich oben angeheftet (sort_order = -1). Du kannst Aufgaben jederzeit von dort in dein "echtes" Projekt verschieben.

Captured from-Marker

Jede vom Companion erzeugte Aufgabe trägt eine Quell-URL. Auf der Aufgaben-Detail-Seite siehst du oberhalb der Beschreibung eine kleine Zeile mit "Captured from <hostname>" — ein Klick darauf öffnet die Originalseite in einem neuen Tab.

Häufige Fragen

Wo kommt das alte Webhook + Token hin? Mit v3.0 entfernt. Die Extension nutzt jetzt den auth_token-Cookie. Falls du vorher einen Custom-Host angegeben hattest, im Popup unter "Settings" neu setzen.

Funktioniert das auf lokalem Dev? Ja — im Popup unter Settings die URL auf http://localhost:3000 ändern. Die Extension routet API-Calls automatisch an :8080.

Was passiert auf Seiten mit strenger CSP (z.B. Banking)? Der Picker injiziert CSS via chrome.scripting.insertCSS, das die Seiten-CSP umgeht. Sollte überall funktionieren — falls nicht, gerne ein Ticket erstellen.

Sind Bilder enthalten? Nein, nur die URL des Bilds. Wir speichern keinen Inhalt auf unseren Servern, wenn die Quelle ein externes Bild ist.

Speichert das Companion meine Browser-Historie? Nein. Es passiert nichts, bis du den Picker öffnest und klickst. Keine Background-Scraping, kein Tracking.