Max Nardit
KI-Agenten

Webseiten mit Share2Agent an Windsurf senden

Sende Dokumentation, API-Referenzen und Fehlerseiten direkt an Windsurfs AI-Assistant. Share2Agent extrahiert sauberen Text aus jeder Webseite und speichert ihn als Markdown-Datei, die Windsurf lesen kann.

Voraussetzungen

  • Windsurf IDE von Codeium installiert
  • Share2Agent Chrome-Erweiterung installiert
  • Python 3.10+ mit PyYAML (pip install pyyaml)

Schritt 1: Receiver einrichten

Share2Agent nutzt einen leichtgewichtigen Webhook-Receiver, der Seiten als Markdown-Dateien speichert. Windsurf liest diese Dateien als Kontext.

bash
git clone https://github.com/mnardit/share2agent.git
cd share2agent/examples/receiver
pip install pyyaml

Schritt 2: Speicherverzeichnis konfigurieren

Lass PAGES_DIR auf einen Ort innerhalb deines Projekts zeigen (oder auf ein gemeinsames Verzeichnis, auf das Windsurf zugreifen kann):

bash
export PAGES_DIR=~/my-project/references
python3 -u receiver.py

Der Receiver startet auf Port 9876 und speichert jede geteilte Seite als .md-Datei mit YAML-Frontmatter, das URL, Titel, Zeitstempel und einen optionalen Kommentar enthält.

Du kannst PORT und PAGES_DIR auch als Environment-Variablen setzen, um das Skript nicht editieren zu müssen.

Schritt 3: Share2Agent konfigurieren

  1. Klicke auf das Share2Agent-Icon in Chrome.
  2. Öffne Settings.
  3. Setze die Webhook URL auf http://localhost:9876.
  4. Speichere.

Wenn du den Receiver auf einem Remote-Rechner oder via Tailscale betreibst, ersetze localhost durch den Hostnamen deines Rechners.

Schritt 4: Eine Seite teilen

  1. Öffne eine beliebige Doku-Seite, eine Stack-Overflow-Antwort oder eine API-Referenz.
  2. Klicke auf das Share2Agent-Icon.
  3. Schreibe optional einen Kommentar wie "diese API für Authentifizierung nutzen".
  4. Klicke auf Share.

Der Receiver speichert die Seite in deinem konfigurierten Verzeichnis, etwa:

~/my-project/references/2026-03-28-1430-nextjs-middleware-docs.md

Schritt 5: In Windsurf referenzieren

Öffne den AI-Chat von Windsurf (Cascade) und referenziere die gespeicherte Datei:

  • Gib den Dateipfad direkt im Prompt an
  • Oder hänge das References-Verzeichnis an deinen Workspace, sodass Cascade es automatisch indexiert

Beispiel-Prompt:

Schau in references/2026-03-28-1430-nextjs-middleware-docs.md und hilf
mir, Middleware-basierte Auth nach dem dort beschriebenen Pattern zu
implementieren.

Windsurf nimmt den Markdown-Inhalt als Kontext für seine Antwort auf.

Als Background-Service betreiben

Damit der Receiver ohne Terminalfenster läuft:

bash
# systemd user service
mkdir -p ~/.config/systemd/user
cat > ~/.config/systemd/user/share2agent-receiver.service << 'EOF'
[Unit]
Description=Share2Agent Webhook Receiver
 
[Service]
Environment=PAGES_DIR=%h/my-project/references
ExecStart=/usr/bin/python3 -u /path/to/receiver.py
Restart=on-failure
 
[Install]
WantedBy=default.target
EOF
 
systemctl --user daemon-reload
systemctl --user enable --now share2agent-receiver

Was als Nächstes?

  • Pro Projekt organisieren - betreibe mehrere Receiver mit unterschiedlichen PAGES_DIR-Werten für unterschiedliche Workspaces.
  • Cleanup-Skript ergänzen - lösche Referenzdateien, die älter als 7 Tage sind, um deinen Workspace sauber zu halten.
  • Mit Windsurf-Rules kombinieren - lege eine .windsurfrules-Datei an, die Cascade anweist, vor Antworten immer das references/-Verzeichnis nach relevantem Kontext zu durchsuchen.
Webseiten mit Share2Agent an Windsurf senden