Comment on page

Block Basics

The basics of creating, selecting, and navigating between Blocks.

The Basics

  • Blocks group your command and command output
  • The Input Editor can pin to the bottom, pin to the top, or start at the top.
  • Blocks grow from the bottom to the top.
  • Blocks are color-coded. Blocks that quit with a non-zero exit code have a red background and red sidebar.
Try it yourself! Type xyz (or some other command that doesn’t exist) and hit ENTER

Create A Block

  1. 1.
    Execute a command (type ls and hit ENTER) in the Input Editor at the bottom of the screen.
  2. 2.
    Your command and output is grouped into a Block.
  3. 3.
    Try executing a different command (type echo hello and hit enter).
  4. 4.
    Warp adds your newly created Block to the bottom (directly above the input editor).
Create a Block

Select a Single Block

  • Using your mouse: click on a Block.
  • Or using your keyboard: hit CMD-UP to select the most recently executed Block and use the UP ↑ and DOWN ↓ arrow keys to navigate to the desired Block.
  • For long Blocks:
    • You can click "Jump to the bottom of this block".
    • You can press SHIFT-CMD-UP/SHIFT-CMD-DOWN to Scroll to the top/bottom of the selected block.
    • From the Command Palette CMD-P, you can also "Scroll to the top/bottom of selected block".
Select a Single Block

Select Multiple Blocks

  • Click another Block while holding CMD to toggle the selection of that Block, or
  • Click another Block while holding SHIFT to select a range of Block, or
  • Use SHIFT-UP ↑ or SHIFT-DOWN ↓ to expand the active selection (the Block with the thicker border) up or down, respectively.
Select Multiple Blocks
  • Either scroll using your mouse or the scrollbar, or select a Block and use the UP ↑ and DOWN ↓ arrow keys.
  • "Scroll Terminal output up/down one line" is also a way to navigate block output, and can be configured with a keyboard shortcut or accessed from the Command Palette CMD-P.
  • When the output of a command is cut off, Warp keeps the Sticky Command Header pinned at the top that displays the command the Block corresponds to. Clicking the header will scroll the screen to the start of the Block.
Navigate between Blocks