Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.coval.dev/llms.txt

Use this file to discover all available pages before exploring further.

​
Overview

Coval supports a shared keyboard navigation model across major list and detail surfaces. The fastest way to think about it is:
  • Vertical keys move through rows in tables and sidebars
  • Horizontal keys move between sibling detail items
  • Enter opens the current row
  • Escape backs out of the current surface
  • Cmd+K opens the command palette
Not every page supports every shortcut, but list pages and result/detail pages now follow the same general model.

​
Global Shortcuts

​
Command Palette

  • Cmd+K opens the command palette
  • Use it to jump to pages, run contextual page actions, and inspect utility commands such as debug information
  • / focuses the primary search or filter input on supported pages

​
Dismiss and Back

  • Escape closes dialogs, clears the current keyboard selection, or backs out of the current surface
  • b goes back within the current surface on pages that support a local “back to…” action

​
Row Navigation

On table and list pages, the keyboard-active row uses the same highlight model as mouse hover. Use any of these keys to move through rows:
  • j / k
  • w / s
  • ArrowUp / ArrowDown
Then use:
  • Enter to open the selected row
This applies to major list surfaces such as Runs, Conversations, Personas, Templates, Test Sets, Metrics, Targets, and similar secondary sidebars.

​
Detail Navigation

On result and detail pages that belong to a sequence, use horizontal navigation to move between sibling items:
  • h / l
  • a / d
  • ArrowLeft / ArrowRight
Examples include simulation result viewers and other detail pages with previous and next controls in the upper-right header.

​
Working With Searchable Lists

On searchable lists:
  • / focuses the search field
  • Escape clears the search when the field has text
  • Press Escape again to continue unwinding out of the current surface

​
Command Palette Hierarchy

The command palette is organized from most contextual to most general:
  • Focused Item
  • Current Surface
  • Current Page
  • Go To
  • Utility
This makes it easier to find “what can I do right here?” before broader app navigation.

​
Practical Flow

Here is a common pattern for keyboard-only work:
  1. Use Cmd+K to jump to a page
  2. Use j / k to move through rows
  3. Press Enter to open the selected item
  4. Use h / l to cycle through sibling results or detail items
  5. Use b or Escape to back out