sharkdp/bat

A cat(1) clone with wings.

61k stars2.3kforks335issuespushed

github.com/sharkdp/bat ↗

Example reportsign inexamples

Long shot.

Pick an issue a maintainer has asked for help with, and keep the change small.

Only 17 of 174 pull requests from outside contributors were merged, fewer than 1 in 10.

How long it usually takes

merged
About 2 in 10 within a week, about 3 in 10 within a month.

Data until 2 Nov 2026 · checked

How this was counted
What Holt read
Holt read the 200 most recent pull requests on this repo, opened between 1 Aug 2026 and 1 Nov 2026. 174 came from people outside the team, like you, and had been open long enough to get an answer. Those are the ones that show how newcomers are treated.
Words used here
A pull request (PR) is a change you propose to a project. Merged means the maintainers accepted it. An outsider is anyone who isn't on the project's team, like you.
What we read
200 pull requests on GitHub, opened 1 Aug – 1 Nov 2026.
The team and outside contributors
0 of them came from 0 people on the project's team and are left out. The team is everyone GitHub shows as an owner, member or collaborator, plus anyone the history shows merging, closing or formally reviewing other people's pull requests. Everyone else is an outside contributor, including people who come back.
Bots
13 pull requests opened by bots (dependency updates and the like) are left out. Only a maintainer's reply counts as a reply: not a bot, a CLA check, the author, or a passer-by.
Too recent to count
13 pull requests from outside contributors were opened in the last 14 days, too recently to know how they will end, so they aren't counted yet.
Closed by their authors
5 pull requests from outside contributors were closed by the people who opened them.
What decided it
17 pull requests from outside contributors were merged, by 11 different people, out of 174 attempts by 64 people. Of those who got a reply, half heard back within 38 hours. 150 attempts got no reply at all and weren't merged. Only 17 of 174 pull requests from outside contributors were merged, fewer than 1 in 10. 150 of 174 pull requests from outside contributors got no reply at all. Most outside work here is never answered.
The rule
Only pull requests from outside contributors opened between 14 days and a year ago count, so each has had time for an answer and reflects how the project works now. “Worth your time” needs at least 2 of them merged, from at least 2 different people, with at least 3 in 10 people getting their first pull request merged (once 8 or more have tried), at least 1 in 10 merged, no more than half left without any reply, a typical first reply within 3 weeks, and people actually reviewing what gets merged. “Long shot” is a project that merges some outside work but misses one of those: fewer than 3 in 10 newcomers getting in, fewer than 1 in 10 merged, most left unanswered, very slow first replies, or only one person's work getting in. “Not worth your time” is an archived repository, a mirror, a project with nothing merged or pushed in 90 days, merges nobody reviews, fewer than 1 in 20 outside pull requests merged once at least 20 have been decided, or outside pull requests that are almost all ignored. “Personal project” is someone's own project or a small team's, like a hackathon entry, with nothing from outside ever merged. “A list, not code” is a list or a catalogue of entries, like links or package listings, where a merged entry isn't code work. Anything in between is “Not enough evidence”. These rules are fixed; no AI chooses the verdict.
What Holt couldn't check

No AI read the conversations for this report, so it doesn't say how maintainers talk to newcomers or what kind of project this is. The verdict and the numbers are counted straight from GitHub and don't need an AI.

  • Loading other projects…
I still want to contribute here

Starter issues

  • Loading starter issues…

What happened to outside pull requests

  • 17merged
  • 2got a reply but weren't merged
  • 5closed by a bot or their author
  • 150got no reply
  • 17 of 174

    outside PRs merged (10%)

  • 2 days

    is the typical wait for a first reply

  • 11

    people got their first PR merged here

  • 86%

    of outside PRs sat open with no reply (150)

  • 0%

    of outside PRs were closed without a word (0)

  • 64

    different outsiders tried recently

README and contributing guide

bat - a cat clone with wings Build Status license Version info A cat(1) clone with syntax highlighting and Git integration.

Key Features • How To Use • Installation • Customization • Project goals, alternatives English 中文 日本語 한국어 Русский

Syntax highlighting

bat supports syntax highlighting for a large number of programming and markup languages:

Syntax highlighting example

Git integration

bat communicates with git to show modifications with respect to the index (see left sidebar):

Git integration example

Show non-printable characters

You can use the -A/--show-all option to show and highlight non-printable characters:

Non-printable character example

Automatic paging

By default, bat pipes its own output to a pager (e.g. less) if the output is too large for one screen. If you would rather bat work like cat all the time (never page output), you can set --paging=never as an option, either on the command line or in your configuration file. If you intend to alias cat to bat in your shell configuration, you can use alias cat='bat --paging=never' to preserve the default behavior.

File concatenation

Even with a pager set, you can still use bat to concatenate files :wink:. Whenever bat detects a non-interactive terminal (i.e. when you pipe into another process or into a file), bat will act as a drop-in replacement for cat and fall back to printing the plain file contents, regardless of the --pager option's value.

How to use

Display a single file on the terminal

bash
bat README.md

Display multiple files at once

bash
bat src/*.rs

Read from stdin, determine the syntax automatically (note, highlighting will only work if the syntax can be determined from the first line of the file, usually through a shebang such as #!/bin/sh)

bash
curl -s https://sh.rustup.rs | bat

Read from stdin, specify the language explicitly

bash
yaml2json .travis.yml | json_pp | bat -l json

Show and highlight non-printable characters:

bash
bat -A /etc/hosts

Use it as a cat replacement:

bash
bat > note.md  # quickly create a new file

bat header.md content.md footer.md > document.md

bat -n main.rs  # show line numbers (only)

bat f - g  # output 'f', then stdin, then 'g'.

Integration with other tools

fzf

You can use bat as a previewer for fzf. To do this, use bat's --color=always option to force colorized output. You can also use --line-range option to restrict the load times for long files:

bash
fzf --preview "bat --color=always --style=numbers --line-range=:500 {}"

For more information, see fzf's README.

find or fd

You can use the -exec option of find to preview all search results with bat:

bash
find … -exec bat {} +

If you happen to use fd, you can use the -X/--exec-batch option to do the same:

bash
fd … -X bat

ripgrep

With batgrep, bat can be used as the printer for ripgrep search results.

bash
batgrep needle src/

tail -f

bat can be combined with tail -f to continuously monitor a given file with syntax highlighting.

bash
tail -f /var/log/pacman.log | bat --paging=never -l log

Note that we have to switch off paging in order for this to work. We have also specified the syntax explicitly (-l log), as it can not be auto-detected in this case.

git

You can combine bat with git show to view an older version of a given file with proper syntax highlighting:

bash
git show v0.6.0:src/main.rs | bat -l rs

git diff

You can combine bat with git diff to view lines around code changes with proper syntax highlighting:

bash
batdiff() {
    git diff --name-only --relative --diff-filter=d -z | xargs -0 bat --diff
}

If you prefer to use this as a separate tool, check out batdiff in bat-extras.

If you are looking for more support for git and diff operations, check out delta.

xclip

The line numbers and Git modification markers in the output of bat can make it hard to copy the contents of a file. To prevent this, you can call bat with the -p/--plain option or simply pipe the output into xclip:

bash
bat main.cpp | xclip

bat will detect that the output is being redirected and print the plain file contents.

man

bat can be used as a colorizing pager for man, by setting the MANPAGER environment variable:

bash
export MANPAGER="bat -plman"
man 2 select

(on some older Debian or Ubuntu releases, the executable is named batcat instead of bat)

If you prefer to have this bundled in a new command, you can also use batman.

Where newcomer work lands

Contributing here

who's here
512 people have had code accepted here, with 236 pull requests open now.
how active
Last release v0.26.1, · last code pushed .

Merge plan

coming soon

What to do here to get merged

  • Your first pull request, step by step
  • What gets merged here
  • Why outside ones get closed

In the maintainers' own words.

More about this project · numbers, languages, contributors
  • Newcomer PR merged

    Outside contributor's pull request #4076 was merged: “Fix the first line of UTF-16BE input swallowing the second line”

    #4076 on GitHub
  • Newcomer PR merged

    Outside contributor's pull request #4069 was merged: “Add syntax mapping for Podman `.quadlets` files”

    #4069 on GitHub
  • Newcomer PR merged

    Outside contributor's pull request #4068 was merged: “Report BAT_CONFIG_DIR in bat --diagnostic”

    #4068 on GitHub
  • Newcomer PR merged

    Outside contributor's pull request #4067 was merged: “Document StripAnsiMode and its variants”

    #4067 on GitHub
  • Newcomer PR, no reply

    Outside contributor's pull request #4088 had no reply from anyone when we looked: “docs(man): document the "default" --theme special value”

    #4088 on GitHub

Was this verdict right?

Know this project? Tell us. It helps us get verdicts right.

Compare with another repo

Choosing between projects? See which one replies faster and merges more pull requests from newcomers.

Maintainer of this repo?

See what would earn it a Holt badge. Get a badge →