Skip to main content

Keyboard Shortcuts

Complete reference for keyboard shortcuts in Agents Session Viewer.

Message Navigation​

KeyActionDescription
jNext MessageMove selection to the next message in the conversation
kPrevious MessageMove selection to the previous message in the conversation
ggJump to TopScroll to the first message in the conversation
GJump to BottomScroll to the last message in the conversation

Session Navigation​

KeyActionDescription
JNext SessionSwitch to the next session in the sidebar
KPrevious SessionSwitch to the previous session in the sidebar

Scrolling​

KeyActionDescription
Ctrl+dScroll DownScroll down half a page
Ctrl+uScroll UpScroll up half a page
SpacePage DownScroll down one full page

Actions​

Message Actions​

KeyActionDescription
oToggle CollapseCollapse or expand the currently selected message
yYank MessageCopy the currently selected message to clipboard
YYank ConversationCopy the entire conversation as Markdown to clipboard

Search and UI​

KeyActionDescription
/Focus SearchMove focus to the search input field
EscExit SearchClear search and remove focus from search field

macOS Shortcuts​

File Operations​

KeyActionDescription
Cmd+SSave as MarkdownExport conversation as .md file with native save dialog
Cmd+Shift+SSave as JSONExport conversation as .json file with native save dialog
Cmd+EShareOpen macOS share sheet for current conversation
Cmd+WClose WindowClose the current window
Cmd+QQuitQuit the application

Edit Operations​

KeyActionDescription
Cmd+CCopyCopy selected text to clipboard
Cmd+ASelect AllSelect all text in focused element

View Operations​

KeyActionDescription
Cmd+BToggle SidebarShow or hide the session list sidebar
Cmd+Alt+IDeveloper ToolsOpen Electron developer tools for debugging

Mouse Actions​

  • Click Session -- Open that session's conversation
  • Hover Session -- Preview session metadata

Messages​

  • Click Message -- Select message (enables keyboard actions)
  • Click Collapse Button -- Toggle message collapse state
  • Click Copy Button -- Copy message text to clipboard
  • Click Share Button -- Share message via macOS share sheet
  • Click Theme Toggle -- Switch between light and dark mode
  • Click Sidebar Toggle -- Show/hide sidebar
  • Click Search Bar -- Focus search input

Tips and Tricks​

Selection​

  • Messages show a blue ring when selected via keyboard navigation
  • Only one message can be selected at a time
  • Selection is cleared when clicking outside messages

Combining Shortcuts​

SequenceResult
gg then yCopy the first message
G then YJump to bottom, then yank full conversation
/ then type, then EscQuick search and clear

Efficiency Patterns​

  • Use j/k to quickly scan through messages
  • Use J/K to browse sessions without the mouse
  • Use y to quickly grab code snippets or responses
  • Use o to collapse long messages for a better overview

Search Workflow​

  1. Press / to focus search
  2. Type your query (fuzzy matching works)
  3. Results update in real-time
  4. Press Esc to clear and return to browsing
  5. Use j/k to navigate search results

Export Workflow​

  1. Navigate to session with J/K
  2. Review with j/k and collapse unneeded with o
  3. Press Cmd+S to save as Markdown
  4. Or press Y to quickly yank to clipboard