Keyboard Shortcuts

Master the keyboard shortcuts to double your Mantra productivity. This page lists all available shortcuts, organized by function for easy reference.

Platform Differences

In this documentation, Cmd refers to macOS and Ctrl refers to Windows/Linux. For example, Cmd/Ctrl + K means press Cmd + K on macOS or Ctrl + K on Windows/Linux.

General Shortcuts

These shortcuts work anywhere in Mantra.

Shortcut	Function	Description
Cmd/Ctrl + K	Global Search	Quickly search projects, messages, and files
Cmd/Ctrl + /	Open Help	Show help documentation and shortcut hints
Cmd/Ctrl + ,	Open Settings	Access Mantra settings
Cmd/Ctrl + Q	Quit App	Close Mantra
Cmd/Ctrl + R	Refresh View	Reload current view
Cmd/Ctrl + W	Close Tab	Close current tab

Navigation Shortcuts

Use these shortcuts when browsing conversations and messages.

Message Navigation

Shortcut	Function	Description
J or ↓	Next Message	Jump to next message
K or ↑	Previous Message	Jump to previous message
Cmd/Ctrl + J	Quick Next	Jump to next message (from anywhere)
Cmd/Ctrl + Shift + J	Next User Message	Jump to next message sent by user
Cmd/Ctrl + Shift + K	Previous User Message	Jump to previous message sent by user

Page Navigation

Shortcut	Function	Description
G G	Go to Top	Quickly jump to conversation start
Shift + G	Go to Bottom	Quickly jump to conversation end
Space	Page Down	Scroll down one screen
Shift + Space	Page Up	Scroll up one screen
Home	Page Top	Scroll to page top
End	Page Bottom	Scroll to page bottom

Panel Switching

Shortcut	Function	Description
Cmd/Ctrl + 1	Conversation Panel	Switch to conversation list panel
Cmd/Ctrl + 2	Message Panel	Switch to message details panel
Cmd/Ctrl + 3	Code Panel	Switch to code snapshot panel
Cmd/Ctrl + B	Toggle Sidebar	Show/hide left sidebar
Cmd/Ctrl + \\	Toggle File Tree	Show/hide file tree panel

Time Travel Shortcuts

Browse code history in Time Travel mode.

Timeline Control

Shortcut	Function	Description
←	Previous Point	Step backward on timeline
→	Next Point	Step forward on timeline
[	Jump to Start	Jump to timeline beginning
]	Jump to End	Jump to timeline end
P	Play/Pause	Auto-play timeline

Code View

Shortcut	Function	Description
D	Diff View	Switch to code diff comparison view
S	Source View	Switch to full source view
Cmd/Ctrl + G	Go to Line	Jump to specific line number
Cmd/Ctrl + F	Search in File	Search within current file

File Tree Navigation

Shortcut	Function	Description
Enter	Open File	Open selected file
←	Collapse Directory	Collapse current directory
→	Expand Directory	Expand current directory
Cmd/Ctrl + Shift + E	Focus File Tree	Move focus to file tree

Message Filtering Shortcuts

Quickly filter and search messages.

Search

Shortcut	Function	Description
/	Start Search	Open message search box
Cmd/Ctrl + F	Advanced Search	Open advanced search panel
Enter	Confirm Search	Execute search
Cmd/Ctrl + Enter	Search & Highlight	Search and highlight all matches

Filter Toggle

Shortcut	Function	Description
F U	User Messages Only	Show only user-sent messages
F A	AI Messages Only	Show only AI responses
F T	Tool Calls Only	Show only messages with tool calls
F C	Code Only	Show only messages with code
F E	Errors Only	Show only messages with errors

Clear Filters

Shortcut	Function	Description
Esc	Clear Filter	Clear all current filter conditions
Cmd/Ctrl + Shift + F	Reset Filters	Reset all filters to default state

Editing Shortcuts

Copy and select content.

Copy

Shortcut	Function	Description
Cmd/Ctrl + C	Copy Selection	Copy selected text
Cmd/Ctrl + Shift + C	Copy Code Block	Copy entire code block content
Cmd/Ctrl + Alt + C	Copy Message	Copy complete message content

Selection

Shortcut	Function	Description
Cmd/Ctrl + A	Select All	Select all content in current area
Cmd/Ctrl + Shift + A	Select Message	Select entire message
Double-click	Select Word	Select word at cursor
Triple-click	Select Paragraph	Select paragraph at cursor

Customizing Shortcuts

You can customize shortcuts according to your preferences.

Viewing and Modifying Shortcuts

1. Open Settings (Cmd/Ctrl + ,)
2. Select the "Shortcuts" tab
3. Find the function you want to modify
4. Click the shortcut input field and press your new key combination
5. Click "Save" to confirm changes

Shortcut Conflicts

If your shortcut conflicts with system or other application shortcuts, Mantra will display a warning. We recommend avoiding system-level shortcuts.

Restoring Defaults

To restore default shortcuts after modifications:

1. Open Settings (Cmd/Ctrl + ,)
2. Select the "Shortcuts" tab
3. Click "Restore Defaults" button
4. Confirm the restore operation

Export Shortcut Configuration

You can export your current shortcut configuration in settings, making it easy to sync the same shortcuts across different devices.

Quick Reference

Here's a quick reference for the most commonly used shortcuts:

Category	Shortcut	Function
General	Cmd/Ctrl + K	Global Search
General	Cmd/Ctrl + ,	Open Settings
Navigation	J / K	Switch Messages
Navigation	G G	Go to Top
Time Travel	← / →	Timeline Navigation
Filter	/	Start Search
Filter	Esc	Clear Filter
Edit	Cmd/Ctrl + C	Copy

Next Steps

• Check the FAQ for usage tips
• Learn about Compatibility
• Return to Feature Documentation to explore features in depth