Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Terminal dashboard

mirmir opens the terminal dashboard. All views operate on the same local runtime used by CLI and HTTP clients.

Views

KeyViewPurpose
F1DashboardLive throughput, latency, memory, K/V cache, models, and activity.
F2ModelsSearch, download, inspect, load, unload, and remove checkpoints.
F3ChatStream multi-turn generation, reasoning, metrics, and image input.
F4SettingsInspect 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, and u download, load, and unload;
  • i includes incompatible or over-budget remote results;
  • r opens a destructive removal confirmation;
  • X cancels the selected cancellable operation;
  • f explicitly 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+Right selects a loaded model;
  • Ctrl+P edits one-off generation parameters;
  • Ctrl+K clears the conversation;
  • drop one PNG, JPEG, WebP, or GIF to attach it;
  • Ctrl+D removes the attachment;
  • X requests 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.