Skip to content

A first session ​

The keys here are the Linux defaults; the reference lists all of them, the macOS keys and the leader keymap too.

  1. Open it. Start insensical. You get one project, one tab and one pane running your shell.
  2. Split. Press Ctrl+Shift+O to split right, or Ctrl+Shift+E to split down. The new pane opens in the same directory. Ctrl+Alt+arrow moves between panes. Drag a divider to resize.
  3. Open a tab. Press Ctrl+Shift+T. The shell opens in the project's root, or in the current pane's directory if the project has none. Ctrl+Tab and Ctrl+Shift+Tab go to the next and previous tab.
  4. Open a project. Press Ctrl+Shift+N, leave the name empty, type a directory that exists, such as ~/Projects/quote, and press Enter. Ctrl+Alt+PageDown and Ctrl+Alt+PageUp move between projects.
  5. Float a pane. Ctrl+Shift+D opens a new floating pane. Ctrl+Shift+G floats the current pane, or puts a floating one back. Drag a float by its header and resize it from any edge or corner.
  6. Minimize a pane. Ctrl+Shift+M puts the pane in the dock at the bottom, still running. Click its chip or press Ctrl+Shift+R to bring it back.
  7. Find the pane that needs you. Run sleep 40 in one pane, then switch to another tab. When it ends, the pane becomes done: its tab, its sidebar row and the count at the top of the sidebar show it, and a desktop notification arrives. Press Ctrl+Shift+A to go there. Looking at the pane clears the mark.
  8. Close the window. Everything keeps running. Open insensical again and it's all there.

Two things to know from the start:

  • Closing a pane never asks, whatever is running in it. Closing a tab or a project shows what would end and asks first.
  • Ctrl+Shift+/ shows every key on one sheet, and Ctrl+Shift+P opens the command palette, which lists every command with its key.