bat: A Cat Replacement with Syntax Highlighting and Git Integration

Why bat Replaces cat

Replace cat with bat for syntax-highlighted file viewing, automatic theme detection, and built-in git line status. Configure aliases and integrations.

bat is a drop-in replacement for cat with syntax highlighting, git integration, and automatic paging. It also themes itself based on your terminal's color scheme.

By the end of this 7 min guide, you'll have a working bat setup and practical bat workflows you can use immediately.

• Understand what bat does and why it matters for Terminal
• Install and configure bat for your environment
• Build bat-specific workflows with real examples
• Troubleshoot common bat issues with concrete fixes

Installing bat on Any System

Install bat:

brew install bat

• Terminal environment with appropriate permissions
• No prior bat experience needed
• A terminal with true color support
• Git for version-controlling your config

Themes & Syntax Highlighting

Create a config file at ~/.config/bat/config with your default theme and style. Add a shell alias so cat uses bat everywhere.

Here's a foundational configuration to start with:

# bat config
--theme="Catppuccin-mocha"
--style="numbers,changes,header"
--paging=auto

• Begin with this config and make small, incremental changes
• Document each setting with inline comments
• Test changes one at a time to isolate issues
• Keep your config in a Git repo for easy rollback and sharing

Aliases & Shell Integration

With bat configured, these bat-specific workflows will save you time every day:

• bat file.py view with syntax highlighting
• bat --diff show git changes inline
• bat -p plain mode (no line numbers)
• Pipe output: rg foo | bat
• Use as $MANPAGER for colored man pages

Piping, Paging & Git Integration

Once you're comfortable with bat basics, these advanced techniques will transform your bat workflow:

• Custom themes from Sublime Text color schemes
• Integration with fzf for preview windows
• --tabs for tab character rendering
• Create custom syntaxes with --list-languages

Color & Theme Issues

Here are the most common bat issues and how to fix them:

• No colors? Set BAT_THEME or check terminal truecolor support
• Theme not found? Run bat --list-themes
• Slow on large files? Use --paging=never
• Want cat to use bat? Add alias cat="bat"

Beyond cat

Congratulations — you now have a solid bat foundation. Here's where to go next:

• Explore the official bat documentation for features not covered here
• Join the bat community (GitHub Discussions, Discord, or Reddit)
• Check the related tutorials below for deeper bat dives
• Build your own bat configuration and share it with the community