Help
Getting started with WiFi or ISP
Everything you need for the first few minutes, and answers to the questions people ask most.
Install
Requires macOS 14 Sonoma or later. Download the DMG, open it, and drag WiFi or ISP to Applications. Or, with Homebrew: brew install --cask coreyhaines31/tap/wifiorisp. It's signed and notarized by Apple, and updates itself.
Install with Claude Code or Codex
Paste this into your coding agent and it will install and open the app for you.
Install the macOS app "WiFi or ISP" for me. If Homebrew is installed (check with `command -v brew`), run: brew install --cask coreyhaines31/tap/wifiorisp Otherwise, download and install the signed DMG: curl -fL -o /tmp/WiFiOrISP.dmg https://github.com/coreyhaines31/wifiorisp/releases/latest/download/WiFiOrISP.dmg hdiutil attach -nobrowse -quiet -mountpoint /tmp/wifiorisp-dmg /tmp/WiFiOrISP.dmg ditto "/tmp/wifiorisp-dmg/WiFi or ISP.app" "/Applications/WiFi or ISP.app" hdiutil detach -quiet /tmp/wifiorisp-dmg Then open it with: open -a "WiFi or ISP" It's a menu bar app with no Dock icon. Tell me to look for the two small meters near the clock, and that its welcome window asks about Location access (only used to show the Wi-Fi network name) and opening at login. Finally, run `wifiorisp status` (Homebrew puts it on the PATH; otherwise it's "/Applications/WiFi or ISP.app/Contents/MacOS/wifiorisp") and tell me what it says. Last, ask me whether future agent sessions should know about WiFi or ISP. Only if I say yes, append this to your own global instructions file (~/.claude/CLAUDE.md for Claude Code, ~/.codex/AGENTS.md for Codex), unless it's already there, and tell me which file you changed: When I say the internet is slow, laggy, or dropping, run `wifiorisp status --json` to see whether it's my Wi-Fi or my ISP, and follow its nextSteps. Run `wifiorisp lag` when calls or games stutter, `wifiorisp speed` to compare with my plan, and `wifiorisp report` when I need evidence for my ISP. Ask me before running `wifiorisp speed`: M-Lab publishes each speed test, with my IP address, as open data.
Use it from Claude Desktop
Install the app first, then download wifiorisp.mcpb and double-click it (or drag it onto Claude Desktop) to add the WiFi or ISP extension. Ask Claude “is it my Wi-Fi or my ISP?”, “is my ISP down?”, or “write up last week's outages for my ISP”. It reads the verdict, the log, and the ISP report through the wifiorisp command, and never passes Claude your IP address, your router's hardware address, or where you are (the ISP report does name your time zone, so its times make sense). Speed and lag tests stay off unless you turn them on in the extension's settings, because M-Lab publishes every speed test result, including your IP address.
Want to build it from source instead?
Clone https://github.com/coreyhaines31/wifiorisp and build it from source. It needs Xcode 16 or later. Install XcodeGen and SwiftLint with Homebrew if they're missing, then from the repo root run Scripts/run-local.sh, which builds the app signed to run locally (no Apple Developer account) and opens it. Then run the tests with: cd Packages/WiFiOrISPCore && swift test Read CONTRIBUTING.md before changing any code.
Command line, for you and your AI agent
The wifiorisp command asks the app from Terminal, so you, a script, or Claude Code or Codex can find out what's wrong with the internet without clicking anything. Homebrew puts it on your PATH. If you installed from the DMG, link it once: sudo ln -sf "/Applications/WiFi or ISP.app/Contents/MacOS/wifiorisp" /usr/local/bin/wifiorisp
wifiorisp status # the verdict, the numbers behind it, and what to do next wifiorisp watch # a line after every measurement, until Ctrl-C wifiorisp lag # lag under load, and where it builds up wifiorisp speed # download and upload speed, from M-Lab wifiorisp history --since 24h # timings, slow spells, drops, and tests from the log wifiorisp report --since 7d # the report to send your ISP
Add --json to any of them for output an agent can read: each next step comes with a link to a guide or a command to run. status exits with 2 when it finds a problem. The commands that ask the app open it in the background if it isn't running.
Ask your agent in plain words, like “My Zoom calls keep freezing. Use the wifiorisp command to find out whether it's my Wi-Fi or my ISP, and tell me what to fix.” Or add this to your CLAUDE.md or AGENTS.md:
When I say the internet is slow, laggy, or dropping, run `wifiorisp status --json` to see whether it's my Wi-Fi or my ISP, and follow its nextSteps. Run `wifiorisp lag` when calls or games stutter, `wifiorisp speed` to compare with my plan, and `wifiorisp report` when I need evidence for my ISP. Ask me before running `wifiorisp speed`: M-Lab publishes each speed test, with my IP address, as open data.
Your first two minutes
- Open it from Applications. There's no Dock icon or main window. It lives in the menu bar, as two small meters near the clock.
- Answer the welcome window. Allow Location access if you want to see your Wi-Fi network's name (macOS treats it as location data; the app never reads your location). Leave “Open at login” on so it keeps watching.
- Allow local network access. macOS 15 and later ask once; the app needs it to time your router.
- Allow notifications if you want them. They tell you about drops and weak connections.
- Give it 30 seconds. The first verdict needs a few measurements.
Can't see the icon? On MacBooks with a notch, a full menu bar hides icons behind it. Hold ⌘ and drag other icons aside, or quit a few menu bar apps.
Reading the menu
The two meters are your router (left) and the internet (right). A needle drops when that side is slow, and a weak Wi-Fi signal lowers the router needle. When something is slow, a word appears beside them: WiFi, Router, or ISP. A slash means you're not connected to any network.
| You see | It means |
|---|---|
| Fine: WiFi and ISP both OK | Your router and the internet both answer quickly. |
| Slow: weak WiFi signal | Even your router is slow, and the signal is weak. |
| Slow: WiFi or router, not ISP | Strong signal, but the router is slow: a busy channel, interference, or an overloaded router. |
| Slow: ISP, not WiFi | Your router is quick; the internet past it isn't. |
| Offline: ISP is down, WiFi is fine | Your router answers, nothing past it does. |
| Offline: can't reach your router | Your Mac lost the router. |
Under the verdict, What to do lists the next steps for your situation. Click one to open the right guide, start a test, or export a report for your provider. How the verdict works.
Troubleshooting
It says “Unknown network”
Location access isn't allowed. Click Show Network Name… in the menu, or turn on WiFi or ISP in System Settings → Privacy & Security → Location Services.
The router “doesn't answer probes”
Some routers ignore the probes; the verdict then relies on your signal and the internet's timing. If that's new, check System Settings → Privacy & Security → Local Network and make sure WiFi or ISP is on.
It says “Wired”
Your Mac is using Ethernet, so there's no Wi-Fi signal to show. Your router and the internet are still measured.
I'm on a VPN
It still times the router of the Wi-Fi network underneath. It skips identifying your provider, which would name the VPN.
A speed or lag test failed
Both need a working internet connection. If it's down, the verdict will say so.
Privacy
No analytics and no account. History stays on your Mac. In the background, the app times a handshake to your router and to two internet addresses every few seconds (no data is sent in them), and asks Cloudflare once per network which provider you're on. Speed and lag tests run only when you start them. The full method.
Uninstall
Quit it from its menu and drag it to the Trash. If it opens at login, turn that off first in its Settings, or in System Settings → General → Login Items. With Homebrew, brew uninstall --zap --cask wifiorisp also removes its history and settings.
Still stuck?
Report it on GitHub with your macOS version and what the menu shows.
Ready when you are.
WiFi or ISP is a free Mac menu bar app. It times your router and the internet at the same moment, says which side is slow, and keeps a log you can send your ISP.
brew install --cask coreyhaines31/tap/wifiorisp