DocsConfiguration
View as Markdown

Keyboard Shortcuts

The shortcuts worth learning first in Agentastic — launching agents, moving between worktrees and chats, opening files, editing, and find and replace.

Every binding on this page is a default you can change in Settings > Keybindings. For the complete list — all 131 commands, including terminal chords and Markdown actions — see All Shortcuts.

The five to learn first#

ActionShortcut
Create New Task — open Agent Home and launch an agentCmd+N
Quick Task — launch into the worktree you're already inCmd+K
Next agent needing your attentionCmd+Shift+U
Quick OpenCmd+P
Command Palette — find any command, and see its shortcutCmd+Shift+P

Agents and worktrees#

ActionShortcut
Create New TaskCmd+N
Show Quick TaskCmd+K
Submit task and open the worktreeCmd+Return
Submit with the other interface (Terminal ⇄ Chat)Option+Return
New Workspace…Cmd+Shift+T
Switch Workspace — hold Ctrl and tap Tab to cycle the switcher, release to commitCtrl+Tab
Previous / Next WorkspaceCmd+Option+Up / Down
Switch to Workspace 1–9Cmd+Option+1…9
Next Agent Needing AttentionCmd+Shift+U
Show Kanban BoardCmd+Option+K
Show UsageCmd+Option+U
Show Scheduled TasksCmd+Shift+Y

Chat and terminals#

ActionShortcut
Focus Agent ChatCmd+L
Previous / Next Agent ChatCmd+Ctrl+Up / Down
Toggle Terminal/Chat interfaceCmd+I
Stop the current chat turnCmd+.
Close Agent ChatCmd+Ctrl+W
New Terminal TabCmd+T
New Local Terminal Tab — on your Mac instead of inside the container or cloud VMCmd+Option+T
Insert a newline instead of sendingShift+Return

Files and navigation#

ActionShortcut
Quick OpenCmd+P
New FileCmd+Shift+N
New Markdown DocumentCmd+Option+N
Open…Cmd+O
Add Repository…Cmd+Shift+O
SaveCmd+S
Reveal in Project NavigatorCmd+Shift+J
Reveal Changes in NavigatorCmd+Shift+M
Jump to DefinitionCmd+Ctrl+J
Go Back / ForwardCmd+Ctrl+Left / Right
Navigator Tab 1–9Cmd+1…9

Quick Open modes#

Quick Open (Cmd+P) changes mode based on what you type:

ModePrefixExample
File search(none)AppDelegate
Symbol search@@viewDidLoad
Go to line in this file::42
Open a file at a linename:lineApp.swift:50

Panels and layout#

ActionShortcut
Show or Hide NavigatorCmd+B
Show or Hide InspectorCmd+Option+B
Show or Hide Utility AreaCmd+Option+J
Show or Hide ToolbarCmd+Ctrl+T
Show or Hide InterfaceCmd+Shift+H
Enter or Exit Zen ModeCmd+Ctrl+Z
Focus Editor or Utility AreaCtrl+`
Split Side by SideCmd+D
Split Top and BottomCmd+Shift+D
Previous / Next TabCmd+Shift+[ / ]
Select Previous / Next TabCmd+Option+Left / Right
Close TabCmd+W
Reopen Closed TabCtrl+Shift+T

Editing#

ActionShortcut
Undo / RedoCmd+Z / Cmd+Shift+Z
Move Line Up / DownCmd+Option+[ / ]
Outdent / Indent LineCmd+[ / ]
Outdent / Indent Selected LinesShift+Tab / Tab
Toggle Line CommentCmd+Option+/
Show CompletionsOption+Esc
Show or Hide MinimapCmd+Ctrl+Shift+M
Cycle Markdown viewCmd+Shift+V

Find and replace#

ActionShortcut
Find…Cmd+F
Find and Replace…Cmd+Option+F
Find Next / PreviousCmd+G / Cmd+Shift+G
Use Selection for FindCmd+E
Open Search Navigator (find in project)Cmd+Shift+F
Jump to SelectionCmd+J

Git, tasks, and review#

ActionShortcut
Show DiffCmd+Ctrl+Shift+D
Pull ChangesCmd+Option+X
Run Selected TaskCmd+Shift+R
Stop Selected TaskCmd+.
Run Code ReviewCmd+Option+Shift+R

Customizing shortcuts#

Open Settings (Cmd+,) → Keybindings, or press Cmd+/ to open the shortcuts panel directly.

  1. Find the command — the list is searchable by name and by keyword, so "zoom" finds the font-size commands
  2. Click its current shortcut
  3. Press the combination you want

If the combination is already taken, Agentastic warns you and lets you override it or pick another. Click the X next to a shortcut to leave the command unbound.

When you forget one#

Press Cmd+Shift+P and type what you want to do — the Command Palette shows each command's shortcut next to it, so you learn the binding while you use the command.