carta
batwatch(1)

batwatch1

Watch for changes in files or command output, and print them with bat.

Overview

Usage

batwatch [OPTIONS] FILE...

batwatch [OPTIONS] --command COMMAND [ARG...]

Options

Short Long Description
--command -x Execute a command on an interval.
--file -f Watch a file for changes.
--watcher=[watcher] Use a specific program to watch for file changes. See below for more details.
--interval=[seconds] The interval for executing commands.
--clear Clear the screen before printing the files. This is enabled by default.
--no-clear Do not clear the screen before printing the files.
--color Force color output.
--no-color Force disable color output.

All remaining options are passed through to bat.

Watchers

Batwatch uses external programs to watch for file changes.
Currently, the following programs are supported:

- entr

There is also a fallback poll watcher available.

From bat-extras 2024.08.24-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.