Terminal Block Basics

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.

Note

Try it yourself!
Type xyz (or some other command that doesn’t exist) and hit ENTER

Create a block

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

Select a single block

macOS

• 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”.

Windows

• 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 CTRL-SHIFT-UP/CTRL-SHIFT-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”.

Linux

• 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 CTRL-SHIFT-UP/CTRL-SHIFT-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

macOS

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

Windows

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

Linux

• 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

macOS

• Mouse or scrollbar - Scroll using your mouse, trackpad, or the scrollbar.
• Arrow keys - Select a Block and use UP ↑ and DOWN ↓ to move between Blocks.
• Page scrolling - Press PAGE UP or PAGE DOWN to scroll by one page.
• Jump to top or bottom - Press HOME or END to scroll to the top or bottom of terminal output.
• Scroll within a selected Block - Press SHIFT-CMD-UP or SHIFT-CMD-DOWN to scroll to the top or bottom of the selected Block.
• Scroll one line at a time - “Scroll Terminal output up/down one line” can be configured with a keyboard shortcut in Settings > Keyboard shortcuts 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.

Windows

• Mouse or scrollbar - Scroll using your mouse, trackpad, or the scrollbar.
• Arrow keys - Select a Block and use UP ↑ and DOWN ↓ to move between Blocks.
• Page scrolling - Press PAGE UP or PAGE DOWN to scroll by one page.
• Jump to top or bottom - Press HOME or END to scroll to the top or bottom of terminal output.
• Scroll within a selected Block - Press CTRL-SHIFT-UP or CTRL-SHIFT-DOWN to scroll to the top or bottom of the selected Block.
• Scroll one line at a time - “Scroll Terminal output up/down one line” can be configured with a keyboard shortcut in Settings > Keyboard shortcuts 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.

Linux

• Mouse or scrollbar - Scroll using your mouse, trackpad, or the scrollbar.
• Arrow keys - Select a Block and use UP ↑ and DOWN ↓ to move between Blocks.
• Page scrolling - Press PAGE UP or PAGE DOWN to scroll by one page.
• Jump to top or bottom - Press HOME or END to scroll to the top or bottom of terminal output.
• Scroll within a selected Block - Press CTRL-SHIFT-UP or CTRL-SHIFT-DOWN to scroll to the top or bottom of the selected Block.
• Scroll one line at a time - “Scroll Terminal output up/down one line” can be configured with a keyboard shortcut in Settings > Keyboard shortcuts 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.

Note

During long-running or full-screen commands, PAGE UP, PAGE DOWN, HOME, and END are forwarded to the running program. See the full list of scrolling shortcuts on the Keyboard Shortcuts page.