Terminal dashboard
mirmir opens the terminal dashboard. All views operate on the same local
runtime used by CLI and HTTP clients.
Views
| Key | View | Purpose |
|---|---|---|
F1 | Dashboard | Live throughput, latency, memory, K/V cache, models, and activity. |
F2 | Models | Search, download, inspect, load, unload, and remove checkpoints. |
F3 | Chat | Stream multi-turn generation, reasoning, metrics, and image input. |
F4 | Settings | Inspect and edit effective configuration and secrets. |
Use Tab and Shift+Tab, a function key, or the mouse to switch views. Press
? for context-sensitive help.
The Dashboard aggregates current and mean request rates, memory and K/V-cache history, recent operations, and the active runtime stage without forcing a host synchronization in the generation path.
Models
/starts a Hugging Face search;d,l, andudownload, load, and unload;iincludes incompatible or over-budget remote results;ropens a destructive removal confirmation;Xcancels the selected cancellable operation;fexplicitly allows an over-budget load from the load dialog.
Download progress is streamed from the server. Additional downloads wait in a FIFO queue and can be cancelled before or during transfer.
Download progress
The transfer panel names the repository and current file, and reports both
percentage and transferred bytes. Press X with the active transfer selected
to request cancellation; queued downloads can be cancelled the same way.
Memory preflight
Before loading, MiRMiR combines weight, K/V-cache, and workspace estimates and
compares the result with the accelerator budget. The dialog also reports a safe
context limit. An over-budget result is blocked unless you deliberately press
f; forcing a load does not bypass compatibility checks.
Chat
The input remains locked while a request is active. Streamed reasoning is kept separate from final content, and the view reports TTFT, prefill, decode, and end-to-end throughput.
Ctrl+Left/Ctrl+Rightselects a loaded model;Ctrl+Pedits one-off generation parameters;Ctrl+Kclears the conversation;- drop one PNG, JPEG, WebP, or GIF to attach it;
Ctrl+Dremoves the attachment;Xrequests cooperative cancellation.
During streaming, the active assistant message keeps reasoning collapsible and the composer reports TTFT, prefill rate, decode rate, and token counts. Input is locked until the request finishes or cooperative cancellation completes.
Image attachment is available only when the selected model advertises image
input. The attachment name appears above the prompt; Ctrl+D removes it before
submission.
Activity and cancellation
The Dashboard records long-running operations and their stage. Select a
cancellable operation and press X. MiRMiR marks it as cancelling immediately,
but the operation stops cooperatively at a safe boundary rather than in the
middle of an accelerator kernel.
Settings
The settings view presents the effective value, its source, and whether a
server restart is required. Press Enter to edit the selected setting. The
Hugging Face token can be tested with t, and stored secrets remain redacted.
Exit behavior
Esc opens confirmation. q exits outside the chat input, and Ctrl+C exits
immediately. Only a TUI that owns its temporary runtime shuts it down.