Linewatch

Качество интернета во времени — агент-нативный. Упрощённый speedtest.net, который не останавливается на одной цифре: он продолжает измерения, строит график тенденции, фиксирует обрывы и отдаёт результат вам (или вашему ИИ-агенту) в виде чистого JSON.

Собрано 19 августа 2026. Рабочее название — финальный нейминг можно будет провести обычным порядком позже.

Зачем это нужно

Точечный тест скорости может выглядеть хорошо, хотя линия на самом деле каждый вечер «плавает» или проседает. Для трёх видов сбоев нужны три типа измерений:

Принцип проектирования: тяжёлые тесты редко, дешёвые — часто.

Своих серверов нет: измерения идут через публичные, открытые для CORS speed-эндпоинты Cloudflare (speed.cloudflare.com), поэтому движок бесплатно работает из любого браузера или процесса Node.js.

Related MCP server: netops-mcp

Структура

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

Быстрый старт

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-инструменты: run_speed_test, run_latency_probe, get_history, get_summary, get_store_info.

Агент-нативные принципы

1. Никакой интерактивной авторизации для машин. CLI и MCP работают с одним и тем же локальным JSONL-хранилищем (~/.linewatch/results.jsonl) — append-only, которое удобно грепать и парсить.

2. JSON — основной формат результата; человеческий интерфейс — это просто отрисовка тех же строк.

3. Дешёвые примитивы для автономного использования: агент, подозревающий проблему с сетью, вызывает run_latency_probe (<2 с, ~0 данных) и только при необходимости переходит к run_speed_test (~20 с, ~100–500 MB) — в описаниях инструментов указана такая цена, чтобы агент мог принять решение.

Данные и ограничения

• Тест скорости передаёт данные на полной скорости линии ~18 с: примерно line_Mbps × 18 / 8 MB за тест. Режим мониторинга каждые 15 минут на линии 100 Mbps даёт около 20+ GB в день — на безлимитной оптике это нормально, на тарифах с лимитом выбирайте более редкую периодичность.

• Веб-результаты хранятся в IndexedDB браузера, результаты CLI/MCP — в ~/.linewatch/. Они сводятся вместе в фазе B (облачная синхронизация).

Куда движется проект — см. ROADMAP.md (облачная синхронизация, оповещения, tray-приложение, мобайл, продукт).