Docs / Reference
Keyboard shortcuts
You can do everything with the mouse, but a handful of keys make Flotilla fly. Here are the ones worth learning, starting with the most useful.
There's a pattern to them: ⌘ keys work the app, ⌥ keys work panes, and ⌃ keys work the tabs inside a pane. Plain keys always go to the agent.
Press ⌘/ in Flotilla for the full list, or hold it to peek.
Learn these first
| ⌘N | New agent |
| ⌘O | Find an agent |
| ⌥D ⌥R | Split the pane down or right |
| ⌥↩ | Zoom the pane |
| ⌥[ ⌥] | Previous or next running agent |
| ⌘/ | Show every shortcut |
Agents
| ⌥1 … ⌥9 | Open agent 1 to 9 in a new pane; add ⇧ to open it in this one |
| ⌥W | Stop the agent |
| ⌥Q | Delete the session |
| ⌥⇧Q | Delete all completed sessions |
| ⌥O ⌥X | Open the checkout in VS Code or Xcode |
Panes
| ⌥⇧D ⌥⇧R | Split up or left |
| ⌥S | Smart Organize the grid |
| ⌘⌥ arrows, ⌥H ⌥J ⌥K ⌥L | Move focus between panes |
| ⌥⇥ | Next pane; add ⇧ for the previous |
| ⌥⇧W | Close the pane; the agent keeps running |
An agent's tabs
| ⌃1 … ⌃5 | Agent, Editor, Changes, Pull Requests, Terminal |
| ⌃⇥ | Next tab; add ⇧ for the previous |
| ⌃K | Back to the agent |
| ⌃⇧2 … ⌃⇧5 | Open that tab beside the agent |
| ⌃⇧W | Close the split |
The app
| ⇧⌘N | Add a project |
| ⇧⌘R | Review a pull request from its link |
| ⌘1 ⌘2 ⌘3 | Projects, PRs, Routines |
| ⌘S | Show or hide the sidebar |
| ⌘` | Focus the sidebar; then ↑ ↓ to move, ↩ to open, esc to go back |
| ⌘[ ⌘] | Back or forward through where you've been |
| ⌘T | New window tab |
| ⌘= ⌘− | Bigger or smaller text |
The editor
| ⌘P | Open a file |
| ⇧⌘P | Find a function, type or property |
| ⇧⌘F | Search every file |
| ⇧⌘A | Ask the agent about the selection |
| ⌘-click, ⌃⌘J | Jump to the declaration |
| ⌘L | Go to a line |