Linewatch

Calidad de Internet a lo largo del tiempo — nativo para agentes. Un speedtest.net simplificado que no se detiene en un solo número: sigue midiendo, traza la tendencia, registra las caídas y te entrega la evidencia a ti (o a tu agente de IA) como JSON limpio.

Construido el 19 de agosto de 2026. Etiqueta provisional: el nombre puede pasar por la ronda habitual más adelante.

Por qué existe

Una prueba de velocidad puntual puede verse bien mientras la línea en realidad está parpadeando o cayendo cada noche. Tres modos de fallo requieren tres tipos de medición:

Principio de diseño: pruebas pesadas con poca frecuencia, pruebas baratas con alta frecuencia.

Sin servidores propios: la medición se ejecuta contra los endpoints de velocidad públicos y abiertos a CORS de Cloudflare (speed.cloudflare.com), por lo que el motor funciona desde cualquier navegador o proceso de Node de forma gratuita.

Related MCP server: connectivity-diagnostics

Estructura

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

Inicio rápido

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

Herramientas MCP: run_speed_test, run_latency_probe, get_history, get_summary, get_store_info.

Principios nativos para agentes

1. Sin autenticación interactiva para máquinas. La CLI y MCP acceden al mismo almacén JSONL local (~/.linewatch/results.jsonl) — solo de añadido, greppable, analizable.

2. El JSON es la salida de primera clase; la interfaz humana es una representación de las mismas filas.

3. Primitivas baratas para uso autónomo: un agente que sospecha problemas de red llama a run_latency_probe (<2 s, ~cero datos) y solo escala a run_speed_test (~20 s, ~100–500 MB) cuando es necesario — las descripciones de las herramientas indican esos costes para que los agentes puedan decidir.

Notas de datos

• Una prueba de velocidad transfiere datos a la velocidad completa de la línea durante ~18 s: aproximadamente line_Mbps × 18 / 8 MB por prueba. El modo de monitorización a 15 min en una línea de 100 Mbps ≈ 20+ GB/día — bien en fibra ilimitada, elige un ritmo más lento en planes con límite.

• Los resultados web viven en el IndexedDB del navegador; los de CLI/MCP en ~/.linewatch/. Se fusionan en la Fase B (sincronización en la nube).

Consulta ROADMAP.md para ver hacia dónde va esto (sincronización en la nube, alertas, aplicación de bandeja, móvil, producto).