Skip to content

Keyboard control

The board is fully drivable from the keyboard on macOS.

KeysDoes
⌘⌥ + arrowsmove between cards — 2D on the grid, left/right in the focus strip
⌘⌥Returnfocus mode in and out
⇧⌘⌥ + arrowsswap the selected card with its neighbour
⌃⌘↑ / ⌃⌘↓cycle workspaces
⌘Ksearch
⌥⌘Ccopy the last command’s output
Navigation is relative to the card you are on, in two dimensions; the same keys walk the focus strip left and right, and with Shift they swap two cards.

The stepper that opens from + next to Workspaces is fully keyboard-driven with the same ⌘⌥ chords as the board — plain arrows, Return and Esc stay with whatever card or field has them. A hint at its top-right names the chords of the page you are on.

KeysPageWhat happens
⌘⌥↑ ⌘⌥↓every pagemove the cursor: source tiles, folders, projects, repositories
⌘⌥Return or ⌘⌥→tiles, projects, repositoriesopen the tile, add the project, choose the repository
⌘⌥Return or ⌘⌥→folder browserenter the highlighted folder
⌘⌥←folder browsergo up one folder
⇧⌘⌥ReturnFile System, clone targetCreate the workspace / start the clone
⌘⌥Returnfailed clonetry again
⌘⌥Deleteevery pageback one step; from the first page out of the panel
Tabpages with a text fieldinto the name / filter / URL field as usual

When the new workspace lands on its empty board, the cursor is already on the start options: ⌘⌥↑ ⌘⌥↓ pick a tool, ⌘⌥Return starts it — the whole way from + to a running agent without touching the mouse.

Two rules shaped the layout, and they explain why the shortcuts run slightly long:

Every Offsite shortcut contains Command. macOS reserves Command for the application, so a combination containing it is never delivered to the terminal. That means Offsite can never eat a keybinding your shell, your editor or your agent CLI depends on. Bare Esc, Ctrl-C, Ctrl-R and friends always belong to the session.

Option is there because Command alone collided with the caret. ⌘← and ⌘→ are line-start and line-end in any text field, so board navigation with plain ⌘+arrows did nothing while you were editing a commit message or a file. Moving to ⌘⌥ fixed it: those are not caret commands, so Offsite can intercept them even over a focused editor, and plain ⌘+arrows fall through to the editor untouched.

Arrows and Return are layout-independent, so the shortcuts work the same on a Swiss or a German keyboard.

Every board shortcut holds Command and Option, so the caret keys stay with your text field and the bare keys stay with your session.
  • Implemented as a local NSEvent monitor on the board, which sees the key before the first responder. That is what lets ⌘⌥ combos win over a focused text view by construction rather than by luck.
  • ⌘⌥Esc is deliberately never bound — that is macOS Force Quit.
  • The old shell prompt-jump binding (⌥⌘↑/⌥⌘↓) was removed because it collided with navigation.
  • Plain ↑/↓ navigation inside the Git card’s file list is unchanged and does not need modifiers.
  • iOS has no keyboard shortcut layer; use the command bar instead.