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 or shift+tab 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 ? 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 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 and k keys move the cursor a row, ctrl+d and ctrl+u move it a chunk of rows, and gg and G 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 and N 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 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.
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 to read every message in the main view, where d dismisses the one under the cursor and D dismisses them all.

Visual selection#
Press v to take the row under the cursor into a selection, and V 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.
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 to copy the value of the field under the cursor to your clipboard. / searches the fields the same way it searches the list.