954

Is there a command line switch to pass to git diff and other commands that use the less pager by default? I know these methods exist:

  • git diff | cat... removes all syntax highlighting
  • git config --global core.pager cat sets the pager in the global .gitconfig to cat
  • export GIT_PAGER=cat

But I would prefer a command line switch.

5
  • 19
    Note: core.pager 'less -+F -+X' would be a more recent way to remove those options. See my answer below. Commented Sep 13, 2013 at 8:19
  • 2
    "less -+F -+X" is the magical setting to remove the annoying "...skipping..." markers in long logs. Thanks a lot for those options, you saved my day! Commented May 12, 2014 at 9:04
  • related: stackoverflow.com/questions/12352049/… Commented Mar 28, 2019 at 13:06
  • See related question on using less with git (it varies dependent on less version): unix.stackexchange.com/questions/107315/… Commented Apr 28, 2020 at 8:45
  • 1
    Looking for a solution on Windows? @Jaredcheeda's answer stackoverflow.com/a/57399465/8604951 works . Commented Apr 30, 2021 at 15:30

21 Answers 21

1108

--no-pager to Git will tell it to not use a pager. Passing the option -F to less will tell it to not page if the output fits in a single screen.

Make sure that you add --no-pager or -P before your command, as in git --no-pager log....

Usage:

git --no-pager diff

Other options from the comments include:

# Set an evaporating environment variable to use 'cat' for your pager
GIT_PAGER=cat git diff

# Tells 'less' not to paginate if less than a page
export LESS="-F -X $LESS"

# ...then Git as usual
git diff

# short option alternative
git -P diff
Sign up to request clarification or add additional context in comments.

18 Comments

Or use GIT_PAGER or PAGER environment variables, or core.pager git config variable.
Also, if your terminal clears the screen after exiting less you'll want to add -E to your less options to make -F usable.
Note that if you want to include --no-pager in an alias, you have to prefix the command with it, and to avoid an error, you have to make an alias like this: git config alias.foo '!git --no-pager foo'. Somewhat confusing. Simply aliasing to '--no-pager foo' won't work.
@JimStewart I found git config alias.foo '-c core.pager=cat foo' to work just fine. But as you point out, it complains with a straight --no-pager foo.
--no-pager can also be shortened to -P
|
391

As a previous answer mentioned, passing the -F option to less causes it to quit if the content is less than one screen. However, after doing so, the screen is reset, and you end up not seeing the content.

The -X option does away with that behaviour. So, I use the following to enable conditional paging based on the amount of content:

git config --global --replace-all core.pager "less -F -X"

9 Comments

Note: I had to use git config --global --add core.pager "less -F -X" in git 1.8.0.2, the one above didn't work.
Great! Also to make it behave so not only with git but all programs add something like export LESS="-RFX" to your .bashrc or .zshrc
Yes, as I explained in my answer, I prefer the screen not to be reset before and after the pager starts and exits, especially if it all fits in one screen, which is exactly what -X does. Don't use it if you don't like that. I like it because this way I can refer to things like git SHAs by looking at the result of previous git commands in my history without having to type the command again. Each to his/her own.
As of December 2017 if you are using version 530 of less or higher, you do not need -X, here is a post from unix SE explaining this. less -F will produce the desired behavior.
I think reset shouldn't apply if pager is not being used, and should apply otherwise.
|
246

Use

git config --global core.pager cat

to get rid of a pager for all commands for all repositories.

You can also disable paging for single Git subcommands by using pager.<cmd> setting instead of core.pager, and you can change your settings per Git repository (omit --global).

See man git-config and search for pager.<cmd> for details.

3 Comments

The question was not how to disable pager altogether but how to disable it for the grep subcommand. mtahmed's answer is perfect.
This might be what the extended explanation asked but this is what I was looking for and it was one of the top Google results so thanks @geekQ
This would be terrible if you did git log in a repository with a large number of commits. Or worse, git log -p -- you'd get the entire set of commit diffs dumped into your terminal.
105

You can disable/enable pagers for specific outputs in the global configuration as well:

git config --global pager.diff false

Or to set the core.pager option, just provide an empty string:

git config --global core.pager ''

This is better in my opinion than setting it to cat as you say.

4 Comments

as of this writing ... on Windows / PowerShell I had to manually edit code "$($env:UserProfile)\.gitconfig" and add pager = under the [core] settings. The answer worked for my current powershell session but didn't seem to save the setting anywhere so it was effective on the next launch.
To selectively page other options, use git config --global pager.log "less -F -X" or similar
This is best option when/if you're using similar .gitconfig for Windows and Linux; though git-for-windows do have cat and less, it may not have more; disabling and/or forcing to nothing is more portable to multi-platform without guessing and/or bothering to ask "are you Linux or Windows?"
NB: on Windows, using single quotes in the last command doesn't work, but double quotes do: git config --global core.pager ""
77

The recent changes in the documentation mention a different way of removing a default option for less ("default options" being FRSX).

For this question, this would be (git 1.8+)

git config --global --replace-all core.pager 'less -+F -+X'

For example, Dirk Bester suggests in the comments:

export LESS="$LESS -FRXK" 

so that I get colored diff with Ctrl-C quit from less.

Wilson F mentions in the comments and in his question that:

less supports horizontal scrolling, so when lines are chopped off, less disables quit-if-one-screen so that the user can still scroll the text to the left to see what was cut off.


Those modifications were already visible in git 1.8.x, as illustrated in "Always use the pager for git diff" (see the comments). But the documentation just got reworded (for git 1.8.5 or 1.9, Q4 2013).

Text viewer for use by Git commands (e.g., 'less').
The value is meant to be interpreted by the shell.

The order of preference is:

  • the $GIT_PAGER environment variable,
  • then core.pager configuration,
  • then $PAGER,
  • and then the default chosen at compile time (usually 'less').

When the LESS environment variable is unset, Git sets it to FRSX
(if LESS environment variable is set, Git does not change it at all).

If you want to selectively override Git's default setting for LESS, you can set core.pager to e.g. less -+S.
This will be passed to the shell by Git, which will translate the final command to LESS=FRSX less -+S. The environment tells the command to set the S option to chop long lines but the command line resets it to the default to fold long lines.


See commit 97d01f2a for the reason behind the new documentation wording:

config: rewrite core.pager documentation

The text mentions core.pager and GIT_PAGER without giving the overall picture of precedence. Borrow a better description from the git var(1) documentation.

The use of the mechanism to allow system-wide, global and per-repository configuration files is not limited to this particular variable. Remove it to clarify the paragraph.

Rewrite the part that explains how the environment variable LESS is set to Git's default value, and how to selectively customize it.


Note: commit b327583 (Matthieu Moy moy, April 2014, for git 2.0.x/2.1, Q3 2014) will remove the S by default:

pager: remove 'S' from $LESS by default

By default, Git used to set $LESS to -FRSX if $LESS was not set by the user.
The FRX flags actually make sense for Git (F and X because sometimes the output Git pipes to less is short, and R because Git pipes colored output).
The S flag (chop long lines), on the other hand, is not related to Git and is a matter of user preference. Git should not decide for the user to change LESS's default.

More specifically, the S flag harms users who review untrusted code within a pager, since a patch looking like:

-old code;
+new good code; [... lots of tabs ...] malicious code;

would appear identical to:

-old code;
+new good code;

Users who prefer the old behavior can still set the $LESS environment variable to -FRSX explicitly, or set core.pager to 'less -S'.

The documentation will read:

The environment does not set the S option but the command line does, instructing less to truncate long lines.
Similarly, setting core.pager to less -+F will deactivate the F option specified by the environment from the command-line, deactivating the "quit if one screen" behavior of less.
One can specifically activate some flags for particular commands: for example, setting pager.blame to less -S enables line truncation only for git blame.

7 Comments

@CoreDumpError note: the next Git (2.0.X or 2.1) won't chop line by default! See my edited answer above.
Thanks. This let me figure out that I want export LESS="$LESS -FRXK" so that I get colored diff with ctrl-c quit from less.
@DirkBester Interesting suggestion. I have included it in the answer for more visibility.
Here's a puzzle (well, it is to me): when I set less to quit for <1 screen and not chop lines (i.e. less -F -+S), I get returned to my command prompt after I run the log command. However, if I do have it chop lines (i.e. remove -+S), and any lines get chopped, then when it ends, it doesn't quit immediately, but prints END and waits for me to press q. Is there a way to chop lines and still exit from less automatically after less than a screen?
@WilsonF I don't know, but that sounds like a good question: why not make it a question instead of leaving it here, buried in comments?
|
19

This worked for me with Git version 2.1.4 on Linux:

git config --global --replace-all core.pager cat

This makes Git use cat instead of less. cat just dumps the output of diff to the screen without any paging.

2 Comments

Generally, answers are much more helpful if they include an explanation of what the code is intended to do, and why that solves the problem without introducing others. (This post was flagged by at least one user, presumably because they thought an answer without explanation should be deleted.)
@NathanTuggy I thought it was pretty clear that I was answering the question asked. Seems like some users like to run around flagging short answers for fun. I'll add some text.
11

Regarding the disabled color when piping:

Use --color to avoid that coloring is disabled.

git diff --color | less -R

Or configure it forced on (in e.g. .gitconfig):

[color]
        ui = on

git diff | less -R

For non-color tools, then use:

git diff --no-color | some-primitive-tool

Exporting environment variable LESS=-R (in e.g. .bashrc) turns on color support by default in "less":

git diff | less

1 Comment

Note that git will set the LESS environment variable to FRSX when calling the pager, if it is unset.
11

I like to disable paging from time to time, when I know the output is not very long. For this, I found a neat trick using Git aliases:

git config --global --add alias.n '!git --no-pager'

Or add the following to the [alias] section of ~/.gitconfig:

n = !git --no-pager

This means that you can use the prefix n to turn off paging for any Git command, i.e.:

git n diff # Show the diff without pager
git n log -n 3 # Show the last three commits without pager
git n show v1.1 # Show information about a tag

1 Comment

-P also does no-pager
10

You can add an alias to diff with its own pager with pager.alias, like so:

[alias]
  dc = diff
  dsc = diff --staged
[pager]
  dc = cat
  dsc = cat

This will keep the color on and use 'cat' as the pager when invoked at 'git dc'.

Also, things not to do:

  • use --no-pager in your alias. Git (1.8.5.2, Apple Git-48) will complain that you are trying to modify the environment.
  • use a shell with !sh or !git. This will bypass the environment error, above, but it will reset your working directory (for the purposes of this command) to the top-level Git directory, so any references to a local file will not work if you are already in a subdirectory of your repository.

1 Comment

+1 This technique is useful when you want to navigate by commit after git log but not git log --oneline. Use pager.log = less -FXR +/^commit.*, while special-casing the --oneline option with alias.l1 = log --oneline and pager.l1 = less -FXR.
8

As it says on man git, you can use --no-pager on any command.

I use it on:

git --no-pager diff
git --no-pager log --oneline --graph --decorate --all -n 10

Then use an alias to avoid using (and remembering) long commands.

Comments

8

I have this hunk in my .gitconfig and it seems to work fine (disabled for both diff and show):

[pager]
    diff = false
    show = false

Comments

6
git config --global core.pager ""

This will turn off paging for everything in git, including the super annoying one in git branch.

Comments

5

If you use the oh-my-zsh, in the ~/.oh-my-zsh/lib/misc.zsh file, comment this line:

env_default 'LESS' '-R'

3 Comments

Hey, I think the OP wanted to have a command line switch to use single time with git diff, rather than a permanent global solution. Also, I don't know how good it would be to modify oh-my-zsh source code, since it would be hard to update oh-my-zsh later on. Better set that default value on your .zshrc file.
Thanks,you are right. If use the oh-my-zsh and need a permanent global solution, can add unset LESS in the end of the .zshrc.
Thanks for this. I found the best for me was to set the following in .zshrc - export LESS="-F -E -X $LESS" I prefer not to mess with the files from oh-my-zsh
5

By default git uses uses less as pager. I normally prefer more, as it will print the first page and then allow you to scroll through the content.

Further, the content will remain in the console when done. This is usually convenient, as you often want to do something with the content after lookup (eg. email the commiter and tell him he introduced a bug in his last commit).

If you then want to pipe content, it would be inconvenient to scroll to print everything. The good thing with more is you will be able to combine it with pipeline and it will pipe through everything, eg.

# Find the commit abcdef123 in the full commit history and read author and commit message
git log |grep -C 5 'abcdef123'

Basically more is all you would ever need, unless you do not want the content to remain in the console when done. To use more instead, do as below.

git config --global core.pager 'more'

1 Comment

if you get ugly output with a bunch of highlighted ESC blocks at beginning and ending of lines then use these options to fix it back to color. worked great for me... git config --global core.pager "more -MR " and that is all you need to do
3

Just follow below instructions.

  1. Just type vi ~/.gitconfig in your terminal.
  2. Paste LESS="-F -X $LESS" line.
  3. Press :wq and enter.
  4. Restart your terminal.

Comments

2

I'm surprised I didn't see this answer yet, but simply:

PAGER= git diff ...

Appendix A: I'm on macOS and using zsh, not sure if that changes anything.
Appendix B: As others have pointed out, this is not the best solution if you want to use this as part of a script or uncontrolled environment, where $GIT_PAGER might be set.

Comments

1

For a quick-and-dirty script I wrote, I did it this way:

PAGER=cat git diff ...

1 Comment

This won't work if $GIT_PAGER is set. git --no-pager does the same but more reliably.
1
git -P diff

Or --no-pager.

BTW: To preserve colour with cat

git diff --color=always | cat

Comments

1

Related to this, if you have a default pager set, and you want to create an alias that uses a different pager, you can use the -c option to pass the configuration parameter to just one command.

For example, I have delta configured as my default git pager, but I can create a lessdiff git alias like this, for cases when I want to use less instead.

[alias]
    lessdiff = -c core.pager=less diff

2 Comments

How would you use the alias? I mean you do not define to which command the -c option is for. In which file do you declare it?
These lines go in your git config file. Git knows that this alias config applies to git commands. You can edit the user's global git config like this: git config --edit --global, or you can set up system-wide or per-repo git configurations. I updated my answer to clarify that this is a git alias, not a bash alias.
1

The BEST pagination is less -R -F -X

# Global - all projects (if has no custom local pager)
git config --global core.pager '/usr/bin/less -R -F -X'

# Local - Only on project
git config core.pager '/usr/bin/less -R -F -X'

Comments

1

You have all the right answers except the simplest that teaches you more about how Unix is guided by a composable philsophy.

IF you don't configure your pager in ~/.gitconfig or with git config … you're better setup. Git will use the Posix guided environment variables. See Eviron, and probably a posix manual out there from opengroup.org. Meaning if you edit a commit message you will use $EDITOR or $VISUAL as the command, and if you see a diff or log it will go through $PAGER.

So, yes there's a command line switch, and yes you know you can set the config or GIT_PAGER, BUT hey, you can just call git diff with a one time custom env override, like:

PAGER=cat git diff
# But you don't need to use cat, you can just not set a PAGER this time
PAGER= git diff

And the reason it's good to know this instead of exporting the setting of the PAGER or GIT_PAGER or using command specific config values is it doesn't affect any other invocation. Further while git -P diff works too, what doesn't work is when you have a toolset, like E.G. Graphite which normally passes through to git, gt -P diff should work, but doesn't because it assumes the earlier args are just for it and that all git args are after the command argument. Similarly gt l is nice, but won't stay in your scroll-back if PAGER=less; In such cases it's good to have the fall back knowledge to just call:

PAGER= gt l

Which also fixes your 1-time issue with git when you're working with another tool like Graphite, as above.

IIRC you can chain more vars easily enough:

PAGER=less LESS=-R gt l # doesn't do what you want, yet shows colors in less 

OTOH if you read the less manual you might find something that keeps the color codes, doesn't switch you to the alternate terminal screen which is removed from terminal scrollback, and doesn't clear the screen when starting or exiting, and lastly won't prompt for page if the line count is less than a page full of text.

PAGER=less LESS=-RXF gt ls

Fun; IMO. I currently use:

echo /$EDITOR/$VISUAL/$PAGER/$LESS/  
/vim/zed --wait/less/-R/

Comments

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge you have read our privacy policy.

Start asking to get answers

Find the answer to your question by asking.

Ask question

Explore related questions

See similar questions with these tags.