{
 "schema_version": 1,
 "generated": "2026-10-26",
 "id": "maximpri-mlxtop--check-model-server-over-ssh",
 "repo": "maximpri/mlxtop",
 "repo_url": "https://github.com/maximpri/mlxtop",
 "repo_slug": "maximpri-mlxtop",
 "title": "Check a remote model server over SSH",
 "page_title": "How to check a remote model server over SSH with Mlxtop",
 "summary": "Print a text report of a headless machine's local LLM health without opening a dashboard.",
 "who": "An 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.",
 "problem": "Opening a full dashboard on a server is awkward, and automated checks need plain text output they can read and compare.",
 "outcome": "A text report from `mlxtop --once` shows the runtime readings, and `mlxtop doctor` confirms which readings are available on that machine.",
 "steps": [
  "Install Mlxtop on the server with `brew install maximpri/tap/mlxtop` or the install script for that platform.",
  "Connect over SSH to the server.",
  "Run `mlxtop doctor` to check the runtime connection and which readings are available.",
  "Run `mlxtop --once` to print a text report and exit."
 ],
 "agent_prompt": "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.",
 "agents": [
  "any"
 ],
 "difficulty": "Intermediate",
 "time": "30 minutes",
 "basis": "readme",
 "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.",
 "category": "Software and DevOps",
 "tags": [
  "Software and DevOps"
 ],
 "lang": "rust",
 "requirements": [
  "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"
 ],
 "risk": "none",
 "seen_in_the_wild": false,
 "mentioned_publicly": false,
 "risks": [],
 "best": false,
 "score": 0.9,
 "evidence": [],
 "url": "https://dedupedai.com/use-cases/maximpri-mlxtop/check-model-server-over-ssh/",
 "md": "https://dedupedai.com/use-cases/maximpri-mlxtop/check-model-server-over-ssh/index.md",
 "disclaimer": "Deduped lists open-source repositories that belong to other people. We do not own, maintain, audit, or vouch for any of them, and a repo appearing here is not an endorsement or a safety check. The use cases, steps, and prompts are written by AI and may be incomplete, outdated, or just wrong. Where a use case is marked \"Seen in the wild\", we link to public posts where someone described something similar, but we have not verified those posts and the use case itself is still our AI's own write-up. Use all of this at your own risk. Only run code, commands, or agents on systems and accounts you are authorized to use, and read the code and every command before you run it, especially anything that touches credentials, files, or the network. Nothing here is professional, security, legal, or financial advice. All trademarks and project names belong to their respective owners, and their use here does not imply affiliation. Content is provided as is, without warranties of any kind. Found a mistake, a safety problem, or something you want removed? Email hello@dedupedai.com and we will look at it promptly.",
 "api": "https://dedupedai.com/api/v1/usecases/maximpri-mlxtop--check-model-server-over-ssh.json",
 "api_version": "v1"
}