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.

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 always goes to the program.

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.

On macOS the bindings are the same, with Ctrl rather than Cmd, except for picking a tab by number: that is Cmd+1Cmd+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
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
Ctrl+Shift+X Fan out — turn this pane's plan into agents
Ctrl+Shift+A All agents across projects
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+R Resume a past conversation
Ctrl+Shift+O Projects
F1 Help

The window

Keys Action
Ctrl+, Settings
Ctrl+= Increase font size
Ctrl+- Decrease font size
Ctrl+0 Reset font size
Command palette Remote access…
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-click a tab to rename it; an empty name gives it back the title it gives itself.

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