> ## Documentation Index
> Fetch the complete documentation index at: https://docs.coval.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Keyboard Navigation

> Use Coval efficiently with the keyboard across lists, detail views, and the command palette

## 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

<Tip>
  Not every page supports every shortcut, but list pages and result/detail pages
  now follow the same general model.
</Tip>

## 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

### Search

* `/` 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