Citetrail

Lokaler, herkunftsgesicherter Speicher dessen, was Ihr Browser gesehen hat – jede Erinnerung trägt die URL, den Titel und den Zeitstempel, von dem sie stammt.

Citetrail erfasst die Seiten, die Sie tatsächlich gelesen haben, speichert sie auf Ihrem Rechner und macht sie durchsuchbar – für Sie und für Ihre KI-Agenten über MCP. Wenn ein Agent etwas verwendet, das er dort gefunden hat, kann er genau angeben, woher es stammt.

• Status: Vorabversion. Siehe Projektstatus vor der Installation.

• Lizenz: Apache-2.0

• Standardmäßig lokal. Kein Konto, kein Server, kein Upload. Blockierte Seiten schlagen fehl.

Das Problem, das Citetrail löst

Sie lesen sechs Tabs, schließen sie, und jetzt braucht Ihr Coding-Agent das Ding aus Tab vier. Ihre Optionen heute: erneut einfügen, den Agenten das offene Web durchsuchen lassen und hoffen, dass er auf dieselbe Seite stößt, oder eine Antwort ohne Quelle akzeptieren.

Der Browserverlauf weiß, dass Sie eine URL besucht haben. Er weiß nicht, was die Seite gesagt hat, und er kann es Ihrem Agenten nicht mitteilen. Citetrail schließt diese Lücke:

Related MCP server: reprox-mcp

Was „herkunftsgesichert“ hier bedeutet

Jedes gespeicherte Fragment behält eine begrenzte Referenz: Quell-URL, Seitentitel, Erfassungszeitstempel und die Position innerhalb der Seite. Der Abruf gibt das Fragment und diese Referenz zusammen zurück – sie können nicht getrennt werden. Ein Agent, der aus Citetrail antwortet, kann immer sagen, woher er es hat, und Sie können immer das Original öffnen.

Wenn die Quelle nicht mehr existiert, sagt Citetrail, dass die Quelle nicht mehr existiert. Es liefert nicht stillschweigend ein Fragment, als wäre es noch live.

Schnellstart

git clone https://github.com/anonb3ll/citetrail
cd citetrail
python3 -m venv .venv
.venv/bin/pip install -e .
.venv/bin/citetrail init

# 2. Search the local store
.venv/bin/citetrail search "retry backoff"

# Optional: block a sensitive hostname before it can be stored
.venv/bin/citetrail block bank.example.test

# 3. Point an agent at the same local store over MCP
.venv/bin/citetrail mcp --stdio

Der Standardspeicher ist ~/.local/share/citetrail. Setzen Sie CITETRAIL_STORE oder übergeben Sie --store PATH, um ein anderes lokales Verzeichnis zu verwenden. Siehe docs/extension.md, um den entpackten Chromium-Adapter zu laden.

Dokumentation

Häufig gestellte Fragen

Wie lasse ich meinen KI-Agenten meinen Browserverlauf durchsuchen?

Starten Sie den lokalen MCP-Server und registrieren Sie ihn bei Ihrem Agenten. Der Agent fragt Citetrail wie jedes andere MCP-Werkzeug ab und erhält Fragmente mit ihren Quellen. Er erhält niemals direkten Zugriff auf Ihren Browser oder Ihr Profil.

Wo werden meine Daten gespeichert, und wird etwas hochgeladen?

Auf Ihrem Rechner, in einer lokalen Datenbank, die Sie jederzeit löschen können. Citetrail hat keinen Server und führt keine Uploads durch. Siehe docs/privacy.md.

Wie verhindere ich, dass es meine Bank, meine E-Mails oder mein Firmenintranet erfasst?

Die Blockliste. Sie wird vor der Erfassung geprüft und schlägt fehl – wenn die Regeln für eine Seite nicht ausgewertet werden können, wird diese Seite nicht erfasst. Fügen Sie einen Host mit citetrail block bank.example.test hinzu. Die Erfassung nur mit Whitelist ist aufgeschoben.

Kann ein Agent eine Quelle zitieren, die er nicht tatsächlich gelesen hat?

Nicht von Citetrail. Die Referenz reist mit dem Fragment; es gibt keine API, die Text ohne seine Herkunft zurückgibt.

Was passiert, wenn ich offline bin oder eine Seite nicht mehr existiert?

Der Abruf funktioniert offline gegen das, was Sie bereits erfasst haben. Wenn die ursprüngliche URL nicht erreichbar ist, werden Ergebnisse als solche markiert, anstatt stillschweigend als aktuell präsentiert zu werden. Nicht verfügbare und datenschutzblockierte Zustände werden ehrlich gemeldet, nicht versteckt.

Ist das eine Notiz-App oder ein zweites Gehirn?

Nein. Citetrail erfasst und ruft ab; es organisiert nicht Ihr Denken, baut kein Wissensdiagramm auf und verlangt nicht, dass Sie etwas pflegen. Es ist die Infrastruktur für Werkzeuge, die wissen müssen, was Sie gelesen haben.

Funktioniert es in jedem Browser?

Die Erweiterung zielt zuerst auf Chromium-basierte Browser. Die native Brücke zwischen der Erweiterung und dem lokalen Dienst hat echte Grenzen – siehe docs/limitations.md.

Was Citetrail nicht ist

• Kein gehosteter Dienst und kein Synchronisierungsdienst. Ein Rechner, ein Speicher.

• Kein PKM- oder Notizsystem.

• Kein klinisches, Wohlbefindens- oder Aufmerksamkeits-Tracking-Werkzeug. Es macht keine Aussage über Ihre Kognition.

• Kein Scraper. Es erfasst Seiten, die Sie selbst besucht haben, unter Ihren Regeln.

• Keine mobile App.

Siehe docs/limitations.md und docs/private-exclusions.md.

Verwandtes Projekt

Runroom koordiniert Übergaben zwischen KI-Agenten und Menschen mit Review-Gates und einem Prüfpfad. Die beiden Projekte sind unabhängig und keines erfordert das andere; eine optionale Integration zeigt eine Citetrail-Referenz, die eine verwaltete Runroom-Aufgabe speist.

Mitwirken

Lesen Sie CONTRIBUTING.md und CODE_OF_CONDUCT.md. Melden Sie Schwachstellen privat – siehe SECURITY.md.

Projektstatus

Vorabversion, vor 1.0. Schnittstellen werden sich ändern. Citetrail wird veröffentlicht, um herauszufinden, ob andere Menschen das brauchen – wenn Sie es ausprobieren, sagen Sie uns, was Sie abrufen wollten und ob Sie es bekommen haben.

Lizenz

Apache License 2.0. Copyright 2026 The Citetrail Contributors.