Skip to content
Download

A first session ​

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

  1. Open it. Start insensical. The window opens with one project, one tab and one pane running your shell. It's an ordinary terminal, so type in it.
  2. Split. Press Ctrl+Shift+O to split the pane to the right, or Ctrl+Shift+E to split it downwards. The new pane opens in the directory of the pane you split and takes half its space. Press Ctrl+Alt+arrow to move between panes. Drag the divider between two panes to resize them.
  3. Open a tab. Press Ctrl+Shift+T to open a new tab with a shell in the project's root. If the project has no root, the shell opens in the directory of the pane you were in. Ctrl+Tab and Ctrl+Shift+Tab go to the next and previous tab.
  4. Open a project. Press Ctrl+Shift+N. It asks for a name and a directory. Leave the name empty, type a directory that exists, such as ~/Projects/quote, and press Enter. A project opens there, named after the directory. Ctrl+Alt+PageDown and Ctrl+Alt+PageUp move between projects.
  5. Float a pane. Press Ctrl+Shift+D to open a new floating pane above the layout. Press Ctrl+Shift+G to float the pane you're in, or to put a floating pane back into the layout. Drag a float by its header. Resize it from any edge or corner.
  6. Minimize a pane. Press Ctrl+Shift+M to put the pane away in the dock at the bottom of the window. Its program keeps running. To bring it back where it was, click its chip in the dock or press Ctrl+Shift+R.
  7. Find the pane that needs you. In one pane, run a command that takes more than 30 seconds, for example sleep 40, then move to another tab. When the command ends, the pane becomes done. Its tab, its sidebar row and the count at the top of the sidebar show it, and you get a desktop notification. Press Ctrl+Shift+A to go to that pane. Looking at it clears the mark.
  8. Close the window. Everything keeps running. Open insensical again and it's all still 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 you 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.