Using Flockdeck
Keyboard shortcuts
Everything not listed here goes to the focused agent, which needs the rest of the keyboard for itself. That is why almost every binding is on Ctrl+Shift. The exceptions are the ones no terminal program claims: switching tabs, the font size, Ctrl+, for the settings, F1 for this help, and F6 for the rest of the window. The one exception that does take a key from programs is Ctrl+B for the rail, which a terminal program such as tmux or readline also uses; remap it under Settings › Keyboard if one needs it.
These are the defaults. Change or clear any of them under Settings › Keyboard, except picking a tab by number, which is a range rather than one key: press a binding's button and then the new key, Backspace or Delete to leave the action with no binding, or Esc to change nothing.
Inside a terminal Tab belongs to the program running there, so F6 is how the keyboard gets out: it moves between the rail, the top bar, the focused pane's buttons and its terminal, in that order, and Shift+F6 goes the other way. Both work from the prompt bar too. While a dialog is open the keyboard stays there.
Copying and pasting in a terminal works as it does in Windows Terminal. Ctrl+C copies what is selected, and with nothing selected goes to the program as usual, to interrupt it. Ctrl+Shift+C copies too, and Ctrl+V and Ctrl+Shift+V paste. On macOS, Cmd+C and Cmd+V copy and paste, and Ctrl with a letter goes to the program, except for Ctrl+B.
Actions marked Command palette have no binding of their own: press
Ctrl+Shift+K, or Commands at the right of the top bar, and search for
them by name. The palette also has Rename this tab…, Focus the next
pane and Focus the previous pane, which are not in the table below. Type
> first in the palette, or choose Go to…, to list only the places to go
to; Backspace in the empty field goes back to every command.
On macOS the bindings are the same, with Ctrl rather than Cmd, except for picking a tab by number: that is Cmd+1 … Cmd+9 there. Option with a digit is how most Mac layouts type characters such as [, | and #, so it is left to type them.
Panes
| Keys | Action |
|---|---|
| Ctrl+Shift+D | Split right (agent) |
| Ctrl+Shift+E | Split down (agent) |
| Command palette | Split right (choose agent)… |
| Command palette | Split right (shell) |
| Ctrl+Shift+← | Move pane left |
| Ctrl+Shift+→ | Move pane right |
| Ctrl+Shift+↑ | Move pane up |
| Ctrl+Shift+↓ | Move pane down |
| Command palette | Move pane to a tab of its own |
| Command palette | Tile these panes evenly |
| Ctrl+Shift+Z | Zoom pane |
| Command palette | Restart pane |
| Command palette | Lock pane |
| Command palette | Start recording |
| Command palette | Export transcript |
| Command palette | Reveal transcript |
| Ctrl+Shift+Y | Pane info |
| Ctrl+Shift+W | Close pane |
Tabs
| Keys | Action |
|---|---|
| Ctrl+Shift+T | New agent tab |
| Command palette | New agent tab (choose agent)… |
| Ctrl+Shift+N | New shell tab |
| Ctrl+Tab | Next tab |
| Ctrl+Shift+Tab | Previous tab |
| Alt+1 … Alt+9 | Select tab by number |
| Command palette | Merge every tab into this one |
| Command palette | Move tab left |
| Command palette | Move tab right |
Agents
| Keys | Action |
|---|---|
| Ctrl+Shift+B | Toggle broadcast |
| Command palette | Add this pane to broadcast, or take it out |
| Ctrl+Shift+P | Prompt all panes |
| Command palette | Make baton: hand this pane's work to another agent |
| Ctrl+Shift+A | All agents across projects |
| Command palette | Close finished panes — idle agents and cleanly exited panes, in every open project |
| Command palette | Start a team — a manager agent that starts the rest |
| Ctrl+Shift+M | Team — this project's roster, task board and messages |
| Command palette | API keys… |
Git
| Keys | Action |
|---|---|
| Ctrl+Shift+G | Worktrees |
| Ctrl+Shift+S | Review changes, commit and push |
Finding your way
| Keys | Action |
|---|---|
| Ctrl+Shift+K | Command palette |
| F6 | Move to the next part of the window |
| Shift+F6 | Move to the previous part of the window |
| Ctrl+Shift+F | Find in terminal |
| Ctrl+Shift+L | Find pane |
| Ctrl+Shift+R | Resume — reopen a past conversation |
| Ctrl+Shift+O | Projects |
| Ctrl+Shift+U | Next agent that needs you |
| Ctrl+Shift+H | Message the manager |
| F1 | Help |
The window
| Keys | Action |
|---|---|
| Ctrl+, | Settings |
| Ctrl+B | Expand or collapse the rail |
| Ctrl+= | Increase font size |
| Ctrl+- | Decrease font size |
| Ctrl+0 | Reset font size |
| Command palette | Flockdeck Remote… |
| Command palette | Helper apps… |
| Command palette | Open recordings folder |
| Command palette | Detach — close the window, leave agents running |
| Command palette | Quit — stop every agent in every project |
Panes are focused by clicking, resized by dragging the divider between them, moved by dragging their header, and closed, restarted or zoomed from the buttons in their header; double-clicking the header, away from its buttons, zooms it too. Double-click a tab, or press F2 while the keyboard is on it, to rename it; an empty name gives it back the title it gives itself. Middle-click a tab to close it.
A divider can be resized from the keyboard too: reach it with Tab, then the arrow keys move it and Home shares the room equally. In the tab bar, ← and → move between tabs, and Home and End go to the first and the last.
Inside a dialog
- Esc closes any dialog, the command palette and the prompt bar, and the find bar while the keyboard is in it. In a search field with something typed in it, the first Esc empties the field, and a dialog opened from another goes back to that one. Tab stays inside an open dialog.
- While a dialog is open, the other shortcuts wait until it closes, so nothing changes behind it unseen. The font size keys, Ctrl+Shift+K and F1 still work, and the key that opened the dialog closes it.
- In the command palette, the agent picker and the help's contents, ↑ and ↓ move through the list and Enter takes the one selected.
- In the agent picker, → opens an agent's models and ← closes them, while nothing has been typed to narrow the list.
- In the find bar, Enter goes to the next match and Shift+Enter to the one before. While the find bar is open, F3 and Shift+F3 do the same from the terminal too.