Prompt file imported from achimdehnert/platform (.windsurf/workflows/windsurf-clean.md). Fill in {{GITHUB_DIR}} before use. Copyright stays with the author.

Windsurf Remote Cleanup

Name: windsurf-clean
Author: achimdehnert

Verwende diesen Workflow wenn Windsurf beim SSH Remote Connect folgende Fehler zeigt:

windsurf client: couldn't create connection to server
ECONNREFUSED 127.0.0.1:4XXXX
Restarting server failed

Ursache

Alte Windsurf-Server-Prozesse vom letzten Session-Abbruch laufen noch auf dem dev-server und blockieren den Neustart.

Schritt 1: Interaktives Menü starten (empfohlen)

// turbo Run: ssh -t hetzner-dev 'bash ~/fix-windsurf-remote.sh --menu'

Das Menü zeigt:

═══ Windsurf Cleanup Menü ═══

  1) Sanft      — Nur stale Prozesse (>1h), aktive Sessions bleiben
  2) Workspace  — Nur einen bestimmten Workspace bereinigen  
  3) Force      — ALLE Windsurf-Prozesse killen (Notfall)
  4) Status     — Aktive Windsurf-Sessions anzeigen
  q) Abbrechen

Auswahl [1-4, q]:

Alternative: Direkte Befehle

# Sanft (nur stale Prozesse)
ssh hetzner-dev 'bash ~/fix-windsurf-remote.sh --clean'

# Force (Notfall - killt ALLE Sessions)
ssh hetzner-dev 'bash ~/fix-windsurf-remote.sh --force'

Erwartete Ausgabe:

═══ Windsurf Remote-SSH Fix — ECONNREFUSED 44341 ═══
[INFO]  User: root (Target: deploy)
[INFO]  Sanfter Modus: Nur stale Prozesse (>1h) werden bereinigt.
✅ Cleanup abgeschlossen. Windsurf neu verbinden.

Schritt 2: Windsurf reconnecten

In Windsurf: F1 → Remote-SSH: Connect to Host → dev-server

Oder unten links auf SSH: dev-server klicken → Reconnect.

Schritt 3: Verify

// turbo Run: ssh hetzner-dev 'pgrep -u deploy -f windsurf-server | wc -l && echo processes running'

Nach erfolgreichem Reconnect sollten 3-5 Prozesse laufen (normal).

Bei häufigen Problemen: Vollständiger Fix

Wenn das Problem wiederholt auftritt, einmalig den vollen Fix ausführen:

scp {{GITHUB_DIR}}/platform/docs/adr/inputs/fix-windsurf-remote.sh hetzner-dev:~/
ssh hetzner-dev 'bash ~/fix-windsurf-remote.sh'

Das installiert:

SSH-Server Keepalive (30s/4)
Systemd Cleanup-Timer (alle 4h)
Node.js Memory-Limit (2GB)

# Windsurf Remote Cleanup Verwende diesen Workflow wenn Windsurf beim SSH Remote Connect folgende Fehler zeigt: - `windsurf client: couldn't create connection to server` - `ECONNREFUSED 127.0.0.1:4XXXX` - `Restarting server failed` ## Ursache Alte Windsurf-Server-Prozesse vom letzten Session-Abbruch laufen noch auf dem dev-server und blockieren den Neustart. ## Schritt 1: Interaktives Menü starten (empfohlen) // turbo Run: `ssh -t hetzner-dev 'bash ~/fix-windsurf-remote.sh --menu'` Das Menü zeigt: ``` ═══ Windsurf Cleanup Menü ═══ 1) Sanft — Nur stale Prozesse (>1h), aktive Sessions bleiben 2) Workspace — Nur einen bestimmten Workspace bereinigen 3) Force — ALLE Windsurf-Prozesse killen (Notfall) 4) Status — Aktive Windsurf-Sessions anzeigen q) Abbrechen Auswahl [1-4, q]: ``` ### Alternative: Direkte Befehle ```bash # Sanft (nur stale Prozesse) ssh hetzner-dev 'bash ~/fix-windsurf-remote.sh --clean' # Force (Notfall - killt ALLE Sessions) ssh hetzner-dev 'bash ~/fix-windsurf-remote.sh --force' ``` Erwartete Ausgabe: ``` ═══ Windsurf Remote-SSH Fix — ECONNREFUSED 44341 ═══ [INFO] User: root (Target: deploy) [INFO] Sanfter Modus: Nur stale Prozesse (>1h) werden bereinigt. ✅ Cleanup abgeschlossen. Windsurf neu verbinden. ``` ## Schritt 2: Windsurf reconnecten In Windsurf: `F1` → `Remote-SSH: Connect to Host` → `dev-server` Oder unten links auf `SSH: dev-server` klicken → Reconnect. ## Schritt 3: Verify // turbo Run: `ssh hetzner-dev 'pgrep -u deploy -f windsurf-server | wc -l && echo processes running'` Nach erfolgreichem Reconnect sollten 3-5 Prozesse laufen (normal). ## Bei häufigen Problemen: Vollständiger Fix Wenn das Problem wiederholt auftritt, einmalig den vollen Fix ausführen: ```bash scp {{GITHUB_DIR}}/platform/docs/adr/inputs/fix-windsurf-remote.sh hetzner-dev:~/ ssh hetzner-dev 'bash ~/fix-windsurf-remote.sh' ``` Das installiert: - SSH-Server Keepalive (30s/4) - Systemd Cleanup-Timer (alle 4h) - Node.js Memory-Limit (2GB)

{ "prompt": "# Windsurf Remote Cleanup\n\nVerwende diesen Workflow wenn Windsurf beim SSH Remote Connect folgende Fehler zeigt:\n- `windsurf client: couldn't create connection to server`\n- `ECONNREFUSED 127.0.0.1:4XXXX`\n- `Restarting server failed`\n\n## Ursache\n\nAlte Windsurf-Server-Prozesse vom letzten Session-Abbruch laufen noch auf dem dev-server\nund blockieren den Neustart.\n\n## Schritt 1: Interaktives Menü starten (empfohlen)\n\n// turbo\nRun: `ssh -t hetzner-dev 'bash ~/fix-windsurf-remote.sh --menu'`\n\nDas Menü zeigt:\n```\n═══ Windsurf Cleanup Menü ═══\n\n 1) Sanft — Nur stale Prozesse (>1h), aktive Sessions bleiben\n 2) Workspace — Nur einen bestimmten Workspace bereinigen \n 3) Force — ALLE Windsurf-Prozesse killen (Notfall)\n 4) Status — Aktive Windsurf-Sessions anzeigen\n q) Abbrechen\n\nAuswahl [1-4, q]:\n```\n\n### Alternative: Direkte Befehle\n\n```bash\n# Sanft (nur stale Prozesse)\nssh hetzner-dev 'bash ~/fix-windsurf-remote.sh --clean'\n\n# Force (Notfall - killt ALLE Sessions)\nssh hetzner-dev 'bash ~/fix-windsurf-remote.sh --force'\n```\n\nErwartete Ausgabe:\n```\n═══ Windsurf Remote-SSH Fix — ECONNREFUSED 44341 ═══\n[INFO] User: root (Target: deploy)\n[INFO] Sanfter Modus: Nur stale Prozesse (>1h) werden bereinigt.\n✅ Cleanup abgeschlossen. Windsurf neu verbinden.\n```\n\n## Schritt 2: Windsurf reconnecten\n\nIn Windsurf: `F1` → `Remote-SSH: Connect to Host` → `dev-server`\n\nOder unten links auf `SSH: dev-server` klicken → Reconnect.\n\n## Schritt 3: Verify\n\n// turbo\nRun: `ssh hetzner-dev 'pgrep -u deploy -f windsurf-server | wc -l && echo processes running'`\n\nNach erfolgreichem Reconnect sollten 3-5 Prozesse laufen (normal).\n\n## Bei häufigen Problemen: Vollständiger Fix\n\nWenn das Problem wiederholt auftritt, einmalig den vollen Fix ausführen:\n\n```bash\nscp {{GITHUB_DIR}}/platform/docs/adr/inputs/fix-windsurf-remote.sh hetzner-dev:~/\nssh hetzner-dev 'bash ~/fix-windsurf-remote.sh'\n```\n\nDas installiert:\n- SSH-Server Keepalive (30s/4)\n- Systemd Cleanup-Timer (alle 4h)\n- Node.js Memory-Limit (2GB)", "variables": [ "GITHUB_DIR" ], "notes": "Kill stale Windsurf remote server processes on dev-server to fix ECONNREFUSED reconnect errors", "metadata": { "source": { "provider": "github-windsurf-workflows", "repository": "https://github.com/achimdehnert/platform", "path": ".windsurf/workflows/windsurf-clean.md", "ref": "f87117d3d18ba25bf9a796dce5dee294fbf89b79", "url": "https://github.com/achimdehnert/platform/blob/f87117d3d18ba25bf9a796dce5dee294fbf89b79/.windsurf/workflows/windsurf-clean.md", "key": "achimdehnert/platform/.windsurf/workflows/windsurf-clean.md" } } }

windsurf-clean

About

Windsurf Remote Cleanup

Ursache

Schritt 1: Interaktives Menü starten (empfohlen)

Alternative: Direkte Befehle

Schritt 2: Windsurf reconnecten

Schritt 3: Verify

Bei häufigen Problemen: Vollständiger Fix

Use it

Manifest

Reviews