Claude Code plugin · Claude Desktop extension · MIT

Why is my internet bad?
Ask Claude.

network-doctor measures your Wi-Fi, how much lag you get while the line is busy, call quality and your 4G/5G signal. Then it reads your router and proposes a fix. Nothing changes until you say yes.

"My voice keeps breaking in meetings."

Speed tests say the line is fine. The real culprit is usually lag under load: when anything uploads or downloads, the router queues your voice packets behind it. network-doctor measures exactly that, on the same UDP path a call uses.

The numbers on the right come from the built-in demo network, the same synthetic data used in every recording on this page.

call probe · p95 latency · 10 packets/s
idle63 ms
uploading702 ms
downloading245 ms

While uploading, 61% of voice packets arrive later than 150 ms, which is too late to play. Bufferbloat grade: F.

How it works

One read-only checkup. You get ranked findings, each with evidence and a fix.

Wi-Fi, link, load, calls, MTU and DNS, router, report
wifi

Wi-Fi

Signal, noise, channel and width, plus the neighbouring networks crowding it. It suggests the least busy channel.

bloat

Lag under load

Measures latency while idle, while uploading and while downloading, and grades bufferbloat from A+ to F.

call

Call quality

Loss, jitter and late packets from a voice-like UDP stream to the STUN servers Meet and others use.

mtu · dns

Black holes

Finds PPPoE/VPN MTU problems that make some sites hang, and slow or failing DNS.

router

Your router

4G/5G RSRP, RSRQ, SINR and band; Wi-Fi config; clients; QoS. Read straight from the router's own API.

fix

Fix, then prove it

It shows a plan, applies it after you approve, saves a backup, then re-measures so you see the before and after.

Talks to your router

It reads the cellular signal, Wi-Fi and clients. Every change starts as a plan showing the current and new values. Nothing is sent until you approve it.

Detect

Identifies the router with read-only requests. No login.

Read

Logs in with the password from your OS keychain, and logs out after.

Plan, approve, apply

Automatic backup, plus a one-line revert.

Supported routers

verified means tested on real hardware. experimental means written from public protocol docs and tested against synthetic answers. Own one? Tell us if it works: that's how a driver becomes verified.

FamilyCoversTier
Huawei HiLink5G CPE 5s/Pro, B310-B818, E5577/E5785 MiFi, E3372verified
ZTE MiFi (goform)U20, MU5001, MF971 and most ZTE MiFisverified
ZTE ZXHNH188A, and likely H298A, F670L and ISP-branded gatewaysverified
Huawei home gatewayHG630 V2, HG633, HG658verified
TP-Link ArcherAX / C-series web UIexperimental
TP-Link LTEArcher MR200/MR600, TL-MR6400/MR6500experimental
TP-Link legacyOlder TL-WR / Archer /userRpm/ UI (read-only)experimental
ASUSASUSWRT and Asuswrt-Merlinexperimental
AVM FRITZ!BoxTR-064experimental
MikroTikRouterOS 7 REST, including the LTE monitorexperimental
OpenWrtubus JSON-RPC (LuCI builds), SQM statusexperimental

Router not listed? netdoc.py capture saves a masked snapshot of its web API, with no secrets, MACs, SSIDs or public IPs. Attach it to an Add my router issue.

Install

Nothing to pip install: it needs only Python 3.9+, which ships with macOS developer tools and every Linux. It runs on your computer, so it measures your real network.

/plugin marketplace add dav-ayman/network-doctor
/plugin install network-doctor@network-doctor

Then describe the problem in plain words: "my calls keep breaking up", "why is my Wi-Fi slow?", "check my 5G router's signal". You get the skill and 16 MCP tools.

Built to be safe with your router

Routers lock the admin account after a few wrong passwords, and a bad setting can cut you off. So the rules are strict.

keychain

Passwords never touch the chat

They live in the macOS Keychain or Linux Secret Service, and every output is masked.

bound

Tied to your router

Each stored password is bound to the router's hardware address, so your home password is never offered to the café's 192.168.1.1.

no-retry

No lockouts

A rejected password is remembered, and netdoc won't try again until you fix it. That's one attempt per run, ever.

plan

Plan before change

Every write shows the current and new values first. It runs only after you approve, with a backup and an undo.

FAQ

Does it work with Claude on the web?

Not for measuring your network. Claude on the web runs code in a cloud sandbox, which can't see your Wi-Fi or router. Use Claude Code or the Claude Desktop extension: both run locally.

Will the test slow my connection?

For about 45 seconds the full checkup saturates your upload, then your download. That's how it measures lag under load. Use the quick mode, or skip the load test, if someone is on a call.

Which operating systems?

macOS is first class, and Linux is supported (Wi-Fi details via iw/nmcli). Windows isn't supported yet.

Does it send my data anywhere?

No telemetry. Measurements reach public STUN servers, Cloudflare's speed endpoints (or Apple's networkQuality on macOS) and 1.1.1.1. Router traffic goes only to your router.

My router isn't supported. Can you add it?

Very likely. Run netdoc.py capture and open an "Add my router" issue. The masked capture is enough for someone to write a driver without owning the hardware.