OpenUsage's keymap is grouped by context — global keys are always live, while screen-specific keys only fire when that screen is focused. This page is the high-level orientation. For an exhaustive table of every key, see the keybindings reference.
Contexts
| Context | When active |
|---|
| Global | Everywhere. Help, quit, screen switch. |
| Dashboard | Default screen. Tiles, filter, refresh, theme, time window. |
| Scroll | Inside any scrollable pane. PgUp/PgDn, half-page, top/bottom. |
| Detail | Right-hand detail pane after focusing a tile. Tabbed sections. |
| Analytics | Optional Analytics screen. Sort, filter. |
| Filter mode | After pressing /. Type to filter, Enter to apply. |
| Settings | Modal opened with ,. Per-tab keymaps below. |
| API key edit mode | Inside the API Keys settings tab. Type to overwrite. |
| Provider link picker | Inside the Telemetry settings tab. Pick display provider. |
Global highlights
| Key | Action |
|---|
| ? | Show help overlay |
| q or Ctrl+C | Quit |
| Tab / Shift+Tab | Cycle screens (Dashboard ↔ Analytics) |
| Esc | Pop the current overlay or filter |
Dashboard highlights
| Key | Action |
|---|
| , or Shift+S | Open settings modal |
| / | Filter tiles |
| v / V | Cycle dashboard view (Grid → Stacked → Tabs → Split → Compare) |
| r | Refresh now |
| t | Cycle theme |
| w | Cycle time window (1d, 3d, 7d, 30d, all) |
| Ctrl+O | Expand model breakdown |
| c | Cycle cost visibility for the focused account (auto → hide → show → auto); persists to config |
Detail pane highlights
| Key | Action |
|---|
| Tab / Shift+Tab | Section navigation |
| [ / ] | Tab navigation within a section |
| h / l | Section navigation (vim-style) |
Settings modal highlights
| Key | Action |
|---|
| 1–7 | Jump to tab (Providers, Widget Sections, Theme, View, API Keys, Telemetry, Integrations) |
| Tab / Shift+Tab | Cycle tabs |
| Space / Enter | Activate selection |
| Shift+J / Shift+K | Reorder rows (where applicable) |
| Esc | Close modal |
Filter mode
| Key | Action |
|---|
| Type | Update filter pattern |
| Enter | Apply filter |
| Esc | Clear filter |
| Backspace | Edit pattern |
Mouse
Mouse support is intentionally minimal: wheel scroll only, 3 lines per tick. Click-to-focus and drag are not supported.
Full reference
See Keybindings reference for the complete list including:
- Per-tab key behavior in the settings modal
- Reorder bindings (
Ctrl+↑/↓, Alt+↑/↓ aliases)
- Scroll context (PgUp/PgDn, Ctrl+U/Ctrl+D, Home/End, g/G)
- Telemetry tab keys (window, link picker, clear)
- Integrations tab keys (install, refresh)