BATWATCH(1)

🌸 BATWATCH(1) — the general commands manual ✨

okay bestie so picture this: a whole manual page about batwatch, living its best life in the General Commands Manual. That's the vibe. Let's get into it 💅

🎀 NAME 🎀

batwatch — watches for changes in your files or in command output, and then prints the goods with bat. 👑

💖 DESCRIPTION 💖

✨ USAGE ✨

batwatch [OPTIONS] FILE...

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

yes that's it. that's the whole usage. two modes, both iconic, both slaying 🦋

🔥 OPTIONS 🔥

• -x, --command — run a command instead of watching files, bestie. command mode activated 💀
• -f, --file — file mode, for when you're watching actual files instead ✨
• *--watcher=[watcher]* — okay so this one lets you pick a specific program to watch for file changes with. there are deets down below in the WATCHERS section, go look 👀
• *--interval=[seconds]* — the interval for executing commands. yes, seconds, and yes, you get to decide 🕐
• --clear — clears the screen before printing the files. this is enabled by default, so it's already doing the most 🧚
• --no-clear — do not clear the screen before printing the files. for when you want the chaos to accumulate 🌈
• --color — force color output. make it pretty, no questions asked 🎨
• --no-color — force color output OFF. periodt.

and here's the fun part: all remaining options are passed through to bat. so literally anything else you throw at it? bat catches it. king behavior tbh 🫶

🦋 WATCHERS 🦋

batwatch doesn't do the watching itself — it outsources to external programs (very main character of it, delegating). currently, the following programs are supported:

• entr

there's also a fallback poll watcher available, so if the fancy stuff isn't around, it's still got you. no cap 💜

and that's the whole page bestie!! 💖 this was the batwatch(1) manual page from the General Commands Manual — there's no version or date info tacked on, just the name and the manual, so we're signing off clean. go watch some files ✨🎀