Skip to main content

Keybindings

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

ContextWhen active
GlobalEverywhere. Help, quit, screen switch.
DashboardDefault screen. Tiles, filter, refresh, theme, time window.
ScrollInside any scrollable pane. PgUp/PgDn, half-page, top/bottom.
DetailRight-hand detail pane after focusing a tile. Tabbed sections.
AnalyticsOptional Analytics screen. Sort, filter.
Filter modeAfter pressing /. Type to filter, Enter to apply.
SettingsModal opened with ,. Per-tab keymaps below.
API key edit modeInside the API Keys settings tab. Type to overwrite.
Provider link pickerInside the Telemetry settings tab. Pick display provider.

Global highlights

KeyAction
?Show help overlay
q or Ctrl+CQuit
Tab / Shift+TabCycle screens (Dashboard ↔ Analytics)
EscPop the current overlay or filter

Dashboard highlights

KeyAction
, or Shift+SOpen settings modal
/Filter tiles
v / VCycle dashboard view (Grid → Stacked → Tabs → Split → Compare)
rRefresh now
tCycle theme
wCycle time window (1d, 3d, 7d, 30d, all)
Ctrl+OExpand model breakdown
cCycle cost visibility for the focused account (auto → hide → show → auto); persists to config

Detail pane highlights

KeyAction
Tab / Shift+TabSection navigation
[ / ]Tab navigation within a section
h / lSection navigation (vim-style)

Settings modal highlights

KeyAction
17Jump to tab (Providers, Widget Sections, Theme, View, API Keys, Telemetry, Integrations)
Tab / Shift+TabCycle tabs
Space / EnterActivate selection
Shift+J / Shift+KReorder rows (where applicable)
EscClose modal

Filter mode

KeyAction
TypeUpdate filter pattern
EnterApply filter
EscClear filter
BackspaceEdit 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)