Skip to content

feat(bat): add managed bat config and Catppuccin Macchiato theme#21

Merged
fnayou merged 1 commit into
mainfrom
feat/bat-package
Jun 21, 2026
Merged

feat(bat): add managed bat config and Catppuccin Macchiato theme#21
fnayou merged 1 commit into
mainfrom
feat/bat-package

Conversation

@fnayou

@fnayou fnayou commented Jun 21, 2026

Copy link
Copy Markdown
Owner

Summary

Adds a cross-platform bat Stow package under stow/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

  • confignumbers,changes,header style, auto wrap, italics, auto paging, --theme="Catppuccin Macchiato".
  • themes/Catppuccin Macchiato.tmTheme — vendored from catppuccin/bat so activation is offline and reproducible.
  • package README.md + docs/guides/bat-setup.md.

bat-specific gotcha

bat reads a compiled cache, not .tmTheme files directly. Stow alone does not activate the theme — bat cache --build must 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.

Honest note: implementation preceded the docs this time; the chain was backfilled at the maintainer's instruction and reviewed before commit. Review 0042 records the deviation and a preventive recommendation (decide whether trivial mirror-pattern packages get a documented fast-path or stay on the full chain).

Safety

  • No stow run against $HOME; no bat cache --build run on host — both documented as manual steps.
  • Fake-home simulation: both symlinks land, ~/.config/bat is a real dir (not folded), clean removal.
  • Privacy: clean. Single grep hit (support.token.decorator.python) is a TextMate scope name, not a secret.
  • Status blocks unchanged — package added but not stowed; "no package stowed yet" still holds.

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.
@fnayou
fnayou merged commit 306f5c6 into main Jun 21, 2026
2 checks passed
@fnayou
fnayou deleted the feat/bat-package branch June 21, 2026 02:41
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant