Flockdeck docs

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