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

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

Select a Single Block

Using your mouse: click on a Block.
Or using your keyboard: hit CMD-UP (or CMD-DOWN if input as pinned up top) 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, you can also "Scroll to the top/bottom of selected block".

Using your mouse: Click on a Block.
Or using your keyboard: hit CTRL-UP (or CTRL-DOWN if input as pinned up top) 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-CTRL-UP/SHIFT-CTRL-DOWN to Scroll to the top/bottom of the selected block.
- From the Command Palette, you can also "Scroll to the top/bottom of selected 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.

Click another Block while holding CTRL-SHIFT 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.

Navigate 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.
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.

PreviousBlocks NextBlock Actions

Last updated 9 months ago

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

Select a Single Block

Using your mouse: click on a Block.
Or using your keyboard: hit CMD-UP (or CMD-DOWN if input as pinned up top) 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, you can also "Scroll to the top/bottom of selected block".

Using your mouse: Click on a Block.
Or using your keyboard: hit CTRL-UP (or CTRL-DOWN if input as pinned up top) 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-CTRL-UP/SHIFT-CTRL-DOWN to Scroll to the top/bottom of the selected block.
- From the Command Palette, 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.

Click another Block while holding CTRL-SHIFT 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

Navigate 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.

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