Mac app
MiRMiR for Mac shows the same runtime as the terminal and web dashboards, natively and from the menu bar: live throughput and memory, the model library, chat, sessions, logs and every server you use. To install and connect it, see Mirmir for Mac.
Menu bar
The menu bar icon shows the decode rate while a model generates. Its panel has the loaded model, decode rate with a sparkline of the last minute, prefill, active sessions, prefix cache hits and memory, and shortcuts to the window. Switch loads another local model.
Window
While the window is open, Mirmir is also in the Dock and the app switcher, so it is easy to get back to; closing it leaves the menu bar icon alone. The sidebar lists the screens; the Server card at its bottom names the server they show and switches to another one.
- Overview has decode, prefill, time to first token and memory, a throughput chart over 5 minutes, 1 hour or 24 hours, memory against its limit, and the latest sessions. Rates appear only while the server handles a request.
- Chat streams replies with the model’s reasoning folded above them and shows tokens, decode rate and time to first token under each reply. Each conversation belongs to the server it was started on. With a vision model, the paperclip attaches a PNG, JPEG, GIF, WebP, HEIC or TIFF image (HEIC and TIFF are converted to JPEG). The image stays with the conversation, so follow-up questions and a reopened chat still see it; attaching another replaces it, and the × on the composer’s image removes it before sending. A message with an image is not sent to a model without image input: the app says so and keeps the message.
- Models lists local checkpoints and running downloads with their
features (
tools,think,vision), size and state; All, Ready and Downloading filter the list. The search field filters it at once and, in All and Hugging Face, searches the Hub when you pause typing: results join the list with the memory each needs on this server, and Download returns to your models with the download’s progress. The inspector loads the model and chooses its Context before Load (Automatic, or a token count, with the memory it needs; give each model a context to keep several loaded at once) and edits generation defaults. The context is saved for the model and used by every load, also from the menu bar. - Instances shows each server’s status, loaded models, decode rate and memory, adds, edits and removes remote servers and opens Remote Access for this Mac.
- Sessions lists generations, loads and downloads as they run; Logs follows the app’s server.
- Settings grants model folders and shows the app’s server: its runtime, its OpenAI-compatible API address and its socket.
How it connects
The app bundles the MiRMiR runtime: the same mirmir server as the CLI, with
libmir and MLX, runs as a separate process inside it. The app’s interface is a
client of that runtime’s gRPC service, like the TUI.
The app is sandboxed, and its server inherits the sandbox. On this Mac the app
starts its bundled mirmir with the app’s container as its home, so its
configuration, models, socket and logs stay there, apart from the CLI’s, and
it stops that server when you quit. Its OpenAI-compatible API listens on
127.0.0.1:18080. The server reads only folders you grant in Settings →
Model folders; see Mirmir for Mac.
Remote servers are reached over TLS with a scoped API key from your Keychain and a pinned certificate; see Remote access.