# Navigating komrad

Komrad's navigation is keyboard based, and inspired by vim.

Komrad’s panel has a few sections: the sidebar, the info panel, and the main panel. The view controls what each section shows.

## The sidebar

The sidebar typically lists the resource you’re looking at, such as workflows and their tasks, or what komrad holds in memory and on disk.

The view switcher at the top of the sidebar moves between these subsections. Press [`tab`](https://komrad.dev/latest/config.md#keybindings.views.next) or [`shift+tab`](https://komrad.dev/latest/config.md#keybindings.views.previous) to open the next or previous view.

The details pane underneath shows what komrad knows about the active row. For a task, it shows the task’s directory, branch and pull request.

Finally, the help menu at the bottom of every sidebar lists the available hotkeys. Press [`?`](https://komrad.dev/latest/config.md#keybindings.help.toggle) to bring up the help.

## The main view

The main view is the wide region beside the sidebar. On the agents view, it shows the agent you have opened.

To move between the sidebar and the main view, press komrad’s leader key twice: `ctrl+space`. Komrad also has “jump mode” which lets you jump to any of the different sections on the screen. Press `ctrl+space j` to enter jump mode, which draws a big letter over each section. Komrad also has visual mode, for selecting text, and edit mode, for when you use vim keybindings. The bottom right of the sidebar names your current mode.

To resize the section you’re in, press `ctrl+space h` to push its edge left or `ctrl+space l` to push it right. Right after either, pressing the letter again takes another step without the leader. On the review, the diff sits between the list and the agent, so `ctrl+space h` widens the diff into the list and `ctrl+space l` widens it into the agent.

## The menu

Most actions live in the menu. Press [`space`](https://komrad.dev/latest/config.md#keybindings.menu.open) and it lists what you can do with the row under the cursor, over the screen’s own entries. Each entry names its key, and an entry that opens a further menu, such as git or archive, opens it to the right.

The row you hover decides what the menu holds.

## Navigation, Sorting, and Filtering

Komrad’s keybindings are heavily inspired by Vim.

The [`j`](https://komrad.dev/latest/config.md#keybindings.nav.down) and [`k`](https://komrad.dev/latest/config.md#keybindings.nav.up) keys move the cursor a row, [`ctrl+d`](https://komrad.dev/latest/config.md#keybindings.nav.page_down) and [`ctrl+u`](https://komrad.dev/latest/config.md#keybindings.nav.page_up) move it a chunk of rows, and `gg` and [`G`](https://komrad.dev/latest/config.md#keybindings.nav.bottom) jump to the first and last row. The mouse wheel scrolls whichever region it is over and hands it the keys, as if you had jumped there.

Press `/` to search. Typing lights up the rows that match, and `enter` puts the cursor on the nearest one. Use the [`n`](https://komrad.dev/latest/config.md#keybindings.filter.next_match) and [`N`](https://komrad.dev/latest/config.md#keybindings.filter.prev_match) key to then step through the matches. Lower case text ignores case, and searches support regular expressions.

You can also use the search in “filter” mode. While typing, press Tab to turn it into a filter, which takes every row that does not match off the screen instead of stepping through them.

Press [`f`](https://komrad.dev/latest/config.md#keybindings.tabs.focus) to reach the sort strip over the list, where you pick the column to sort by. Its last stop groups the rows under their workflows. Flattening them makes the list easier to sort by activity or name.

[Video: Moving down the agents list a row and a chunk at a time, searching for lsp and stepping through the matches, filtering the list down to docs, then sorting it by name and flattening it.](https://komrad.dev/media/navigation-moving.mp4)

## Notifications

When komrad reports something, such as an error, its summary flashes for a few seconds at the top of the sidebar. Press [`ctrl+g`](https://komrad.dev/latest/config.md#keybindings.messages.open) to read every message in the main view, where [`d`](https://komrad.dev/latest/config.md#keybindings.messages.dismiss) dismisses the one under the cursor and [`D`](https://komrad.dev/latest/config.md#keybindings.messages.dismiss_all) dismisses them all.

![The messages view beside the agents list, holding an error that says the agent could not start because its build-neovim hook failed, with the hook's output and what to do next.](https://komrad.dev/media/navigation-notifications.png)

## Visual selection

Press [`v`](https://komrad.dev/latest/config.md#keybindings.selection.toggle) to take the row under the cursor into a selection, and [`V`](https://komrad.dev/latest/config.md#keybindings.selection.range) to take in every row between the cursor and the nearest selected one. An action that works on one task then works on every chosen task, such as archiving them, or restoring and deleting them from the archive.

[Video: Selecting three tasks with v and V, then archiving them together from the menu.](https://komrad.dev/media/navigation-selecting.mp4)

## The details

The details under the list show more about the row under the cursor, such as a task’s directory, branch and pull request. Press `ctrl+space j` and the letter over them to move the keyboard there, and press [`y`](https://komrad.dev/latest/config.md#keybindings.clipboard.copy) to copy the value of the field under the cursor to your clipboard. `/` searches the fields the same way it searches the list.

[Video: Moving the keyboard into an agent's details with the pane picker, moving down to its directory, and copying it with y.](https://komrad.dev/media/navigation-details.mp4)
