DEDUPEDWho it is forAn operator or an AI agent managing a headless Mac, Linux box or GPU server that runs a local model and is reachable only over SSH.
The problemOpening a full dashboard on a server is awkward, and automated checks need plain text output they can read and compare.
The outcomeA text report from `mlxtop --once` shows the runtime readings, and `mlxtop doctor` confirms which readings are available on that machine.
What you need first
- macOS 11 or later on Apple Silicon, Linux (x86_64 or ARM64), or Windows (x86_64)
- A local LLM runtime such as oMLX, Ollama, llama.cpp or vLLM installed and able to serve a model
- A terminal, or Rust 1.88 or newer if you build from source
Steps
- Install Mlxtop on the server with
brew install maximpri/tap/mlxtopor the install script for that platform. - Connect over SSH to the server.
- Run
mlxtop doctorto check the runtime connection and which readings are available. - Run
mlxtop --onceto print a text report and exit.
Prompt for your agent
Using the mlxtop repo at maximpri/mlxtop, connect to <target machine> over SSH, run `mlxtop doctor` and then `mlxtop --once`, and return both outputs. Verify that the doctor output lists the runtime connection status before you summarise memory and tokens per second from the report.
Caveat. Mlxtop monitors one server at a time, and polling is sampled, so a request that starts and finishes between two samples can be missed.
Use this in your AI agent
Ask your agent
Using the Deduped MCP, get the setup steps for maximpri/mlxtop and "Check a remote model server over SSH"
Add Deduped to Claude Code once
claude mcp add --transport http deduped https://dedupedai.com/mcp
Every Monday: the 5 hottest repos and exactly how to use them. Free, one email a week, unsubscribe anytime.
Get them freeShare: X LinkedIn Hacker News Email Copy link
Third-party repos we don't own. AI-written use cases can be wrong. Disclaimer