FAQ
Questions, answered
Everything people usually ask before installing StatBar — install, macOS support, privacy, and squeezing the most out of your LLM server.
What is StatBar?
StatBar is a lightweight, native macOS menubar app that shows live CPU (E/P-core), GPU utilization and memory, and a RAM breakdown — plus live metrics from your local LLM server (llama-server, Ollama, LM Studio) such as tokens/sec, KV cache usage, context usage, and model memory.
Which macOS versions are supported?
StatBar requires macOS 15.0 (Sequoia) or later and runs on both Apple Silicon and Intel Macs.
How do I install it?
The quickest ways: `brew install coderhd/tap/statbar`, or `npx statbar` (installs to /Applications automatically). You can also build from source with `./scripts/build-app.sh` — see the Install section on this site.
Does it work with llama-server?
Yes. StatBar auto-detects llama-server, Ollama, LM Studio, and other OpenAI-compatible local servers. For the richest data (KV cache usage, model RAM, token totals) start llama-server with the `--metrics` flag. The server address is configurable in Settings (default http://127.0.0.1:8080).
Is it really free and open source?
Yes. StatBar is MIT-licensed and there is no tracking, no ads, and no telemetry. All metrics are read locally from public macOS APIs and your local server.
Does it use much RAM or battery?
No. It is a single native Swift process. The LLM segment auto-hides when your server is offline, and sampling is cheap and interval-based (configurable from 0.5s to 5s).
Why does CPU show “–” right after launch?
CPU usage is computed from the delta between two tick readings, so the first reading after launch has no baseline yet. It fills in on the next refresh (about one interval).
How do I uninstall?
Via Homebrew: `brew uninstall statbar`. Via npm: `npx statbar uninstall`. Or simply delete /Applications/StatBar.app.
How do I quit or change settings?
Left-click the menubar icon to open the telemetry popover. Right-click for Settings and Quit. Settings let you change the server address, refresh interval, and which segments are shown.
Do you collect any data?
No. StatBar runs entirely on your machine. It reads system metrics locally and queries only the LLM server address you configure. There is no analytics SDK and no network traffic from the app itself.
Still have a question?
Open an issue on GitHub or send an email — you usually get an answer within a day.