Linewatch

Internetqualität im Zeitverlauf — agenten-nativ. Ein vereinfachter speedtest.net, der nicht bei einer Zahl stehen bleibt: Er misst kontinuierlich, visualisiert den Trend, erfasst Aussetzer und übergibt dir die Nachweise (oder deinem KI-Agenten) als sauberes JSON.

Erstellt am 19. Aug. 2026. Arbeitstitel — die Namensgebung kann später die übliche Runde durchlaufen.

Warum es das gibt

Ein punktueller Geschwindigkeitstest kann gut aussehen, während die Leitung tatsächlich jeden Abend flattert oder nachlässt. Drei Fehlerbilder erfordern drei Arten von Messungen:

Designprinzip: schwere Tests sparsam, günstige Tests dicht.

Keine eigenen Server: Die Messung erfolgt über die öffentlichen, CORS-offenen Geschwindigkeits-Endpunkte von Cloudflare (speed.cloudflare.com), sodass die Engine von jedem Browser oder Node-Prozess aus kostenlos funktioniert.

Related MCP server: connectivity-diagnostics

Layout

packages/core   isomorphic measurement engine + stats + types (browser & Node)
packages/cli    `linewatch` CLI — every command speaks --json; JSONL store in ~/.linewatch/
packages/mcp    MCP server (stdio) — agents run tests & read history, zero login
apps/web        PWA — GO button + live gauge, Monitor mode, history charts, CSV export

Schnellstart

npm install
npm run build

# human: web app
npm run dev                      # → http://localhost:5173  (installable as a PWA)

# human or agent: CLI
node packages/cli/dist/index.js test            # one speed test
node packages/cli/dist/index.js monitor         # test every 15m + probe every 45s
node packages/cli/dist/index.js summary --since 7d --json

# agent: MCP (Claude Code)
claude mcp add -s user linewatch -- node $(pwd)/packages/mcp/dist/index.js

MCP-Tools: run_speed_test, run_latency_probe, get_history, get_summary, get_store_info.

Agenten-native Prinzipien

1. Keine interaktive Authentifizierung für Maschinen. CLI und MCP greifen auf denselben lokalen JSONL-Speicher zu (~/.linewatch/results.jsonl) — append-only, grep-fähig, parsebar.

2. JSON ist das erstklassige Ausgabeformat; die Benutzeroberfläche für Menschen ist eine Darstellung derselben Zeilen.

3. Günstige Primitive für die autonome Nutzung: Ein Agent, der Netzwerkprobleme vermutet, ruft run_latency_probe auf (<2 s, ~null Daten) und eskaliert nur bei Bedarf zu run_speed_test (~20 s, ~100–500 MB) — die Tool-Beschreibungen nennen diese Kosten, damit Agenten entscheiden können.

Hinweise zu den Daten

• Ein Geschwindigkeitstest überträgt Daten ~18 s lang mit voller Leitungsrate: ungefähr line_Mbps × 18 / 8 MB pro Test. Überwachungsmodus bei 15 min auf einer 100-Mbps-Leitung ≈ 20+ GB/Tag — auf unbegrenzter Glasfaser in Ordnung, bei Tarifen mit Datenlimit ein langsameres Intervall wählen.

• Web-Ergebnisse liegen in der IndexedDB des Browsers; CLI-/MCP-Ergebnisse in ~/.linewatch/. Sie werden in Phase B (Cloud-Sync) zusammengeführt.

Siehe ROADMAP.md für die weitere Entwicklung (Cloud-Sync, Warnungen, Tray-App, mobil, Produkt).