feat(bat): add managed bat config and Catppuccin Macchiato theme#21
Merged
Conversation
Add a cross-platform bat Stow package under stow/common/bat: - config: numbers/changes/header style, auto wrap, italics, auto paging, and the Catppuccin Macchiato theme activated in-config. - themes/Catppuccin Macchiato.tmTheme vendored from catppuccin/bat so activation is offline and reproducible. - package README and docs/guides/bat-setup.md, including the bat-specific `bat cache --build` activation step (bat reads a compiled cache, not the .tmTheme directly). - root README package table + setup-guide links updated. Inspired by josephschmitt/dotfiles' bat package shape, with the theme switched to Catppuccin Macchiato to match the repo color scheme. Includes the full backfilled decision chain (PRD 0013, architecture 0013, plan 0017, reviews 0041 and 0042). Review 0042 records that implementation preceded the docs and was remediated before commit. Status blocks unchanged: package added but not stowed; stow/common/ remains the source of truth and "no package stowed yet" still holds.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Adds a cross-platform
batStow package understow/common/bat/, with the Catppuccin Macchiato theme — matching the repo-wide color scheme already used by Alacritty, Herdr, and Oh My Posh.Inspired by the public josephschmitt/dotfiles bat package shape, with the theme switched to Catppuccin Macchiato and activated in-config (joseph's leaves it to
BAT_THEME).What's in the package
config—numbers,changes,headerstyle, auto wrap, italics, auto paging,--theme="Catppuccin Macchiato".themes/Catppuccin Macchiato.tmTheme— vendored from catppuccin/bat so activation is offline and reproducible.README.md+docs/guides/bat-setup.md.bat-specific gotcha
bat reads a compiled cache, not
.tmThemefiles directly. Stow alone does not activate the theme —bat cache --buildmust run once after stowing. Documented in the setup guide §6 and troubleshooting.Decision chain
Full chain included: PRD 0013, architecture 0013, plan 0017, reviews 0041 + 0042.
Safety
stowrun against$HOME; nobat cache --buildrun on host — both documented as manual steps.~/.config/batis a real dir (not folded), clean removal.support.token.decorator.python) is a TextMate scope name, not a secret.