How do I clear my bash screen while maintaining scrollback?

Question

The clear command can make the next command easier to read (if it outputs less than a page there's no scrolling hence no searching for the beginning). However it also clears the scrollback buffer which you may not always want.

score 52 · Accepted Answer · answered Jul 27 '11 at 14:33

52

Just press Ctrl-L on the keyboard.

answered Jul 27 '11 at 14:33

Andy Lee Robinson

1,258

score 17 · Answer 2 · answered Aug 12 '20 at 18:41

TL;DR

CtrlL to scroll the current line to the top. The scrollback is not erased.
clear -x to erase the all the lines that are not in the scrollback.
clear to erase all the lines, including the scrollback.

CtrlL is a binding of GNU readline library, which, as Bash manual page says, is what handles reading input when using an interactive shell.

clear-screen (C-L) Clear the screen leaving the current line at the top of the screen.

The CtrlL binding can be reassigned in .inputrc.

clear, on the other hand, is an external command.

$ type clear
clear is /usr/bin/clear

From its manual page,

clear clears your screen if this is possible, including its scrollback buffer (if the extended “E3” capability is defined).

OPTIONS
-x do not attempt to clear the terminal's scrollback buffer using the extended “E3” capability.

score 8 · Answer 3 · edited Mar 20 '17 at 10:04

8

Use tput reset

Thanks to this answer: What commands can I use to reset and clear my terminal?

edited Mar 20 '17 at 10:04

Community

1

answered Jul 26 '11 at 17:36

mcqwerty

593

score 7 · Answer 4 · answered Jul 28 '11 at 23:12

7

the clear command does not clear scrollback for me. so clear or ^L works.

answered Jul 28 '11 at 23:12

Matt

787

Capybara · Answer 5 · 2022-09-16T09:37:11.470

6

In newer versions of clear, it seems that the default behaviour has been changed. To clear the screen and keep scrollback use the option -x. To have the previous behaviour create an alias such as:

alias clear='clear -x'

edited Sep 16 '22 at 09:37

answered Feb 12 '20 at 16:01

Capybara

161
1
2

score 3 · Answer 6 · answered Jul 26 '11 at 17:41

3

If you pipe the output to less, then not only will it clear the screen and show your output at the top, but it will switch back to the previous screen contents when you exit.

answered Jul 26 '11 at 17:41

Darth Android

38,658

score 0 · Answer 7 · answered Aug 18 '23 at 18:31

On MacOs and using vi-mode I added this to my ~/.inputrc:

$if mode=vi
set keymap vi-insert
Control-w: "^[dBxi "
Control-l: 'clear\n'
$endif

Then in my bashrc I have this function:

# clear screen and save scrollback
clear() {
    printf "\\033[H\\033[22J"
}

How do I clear my bash screen while maintaining scrollback?

7 Answers7

TL;DR