From c06d7b7363d2c8cd0fb692dda4709b88a9b1d03e Mon Sep 17 00:00:00 2001
From: bruschill <621389+bruschill@users.noreply.github.com>
Date: Wed, 22 Jul 2026 22:06:56 -0500
Subject: [PATCH] Add Herdr theme (default, protan, tritan)

Herdr (https://herdr.dev) themes are config.toml overrides rather than
standalone theme files, so these are paste-in [theme]/[theme.custom]/[ui]
snippets instead of a single dropped-in file.

- herdr/madeofcode.toml, -protan.toml, -tritan.toml: base catppuccin theme
  with all 15 theme.custom color tokens overridden to the madeofcode
  palette (grays pulled from the existing background ramp, hues matching
  the kitty/ghostty/alacritty ANSI mappings and their colorblind variants)
- herdr/README.md: install steps for both the no-config and
  already-have-a-config cases, including the duplicate-table-header
  gotcha for [ui]
- README.md: add Herdr under Tools, next to Pi, with TOC entry
---
 README.md                    | 15 ++++++
 herdr/README.md              | 96 ++++++++++++++++++++++++++++++++++++
 herdr/madeofcode-protan.toml | 29 +++++++++++
 herdr/madeofcode-tritan.toml | 29 +++++++++++
 herdr/madeofcode.toml        | 29 +++++++++++
 5 files changed, 198 insertions(+)
 create mode 100644 herdr/README.md
 create mode 100644 herdr/madeofcode-protan.toml
 create mode 100644 herdr/madeofcode-tritan.toml
 create mode 100644 herdr/madeofcode.toml

diff --git a/README.md b/README.md
index 584a2c1..4857d03 100644
--- a/README.md
+++ b/README.md
@@ -35,6 +35,7 @@ See the [full color breakdown](#color-breakdown) for the complete palette.
   - [Windows Terminal](#windows-terminal)
 - [Tools](#tools)
   - [Pi](#pi)
+  - [Herdr](#herdr)
 - [Web](#web)
 - [Color breakdown](#color-breakdown)
   - [Accessibility](#accessibility)
@@ -249,6 +250,20 @@ cp pi/madeofcode.json ~/.pi/agent/themes/
 
 Then select **madeofcode** as your theme in Pi. It reuses the same palette and syntax colors as the Vim and JetBrains schemes.
 
+### Herdr
+
+A matching theme for [Herdr](https://herdr.dev), the terminal workspace manager for AI coding agents, lives in `herdr/madeofcode.toml`.
+
+Herdr themes are config overrides rather than standalone files: append the block to your Herdr config, then reload.
+
+```sh
+cat herdr/madeofcode.toml >> ~/.config/herdr/config.toml   # macOS/Linux
+```
+
+On Windows, append it to `%APPDATA%\herdr\config.toml` instead. Apply it with `herdr server reload-config` (or **reload config** from Herdr's global menu) without restarting panes.
+
+Colorblind-safe variants are available as `herdr/madeofcode-protan.toml` and `herdr/madeofcode-tritan.toml`.
+
 ## Web
 
 Syntax-highlighting themes for rendering code on the web live in `web/`:
diff --git a/herdr/README.md b/herdr/README.md
new file mode 100644
index 0000000..11c3be5
--- /dev/null
+++ b/herdr/README.md
@@ -0,0 +1,96 @@
+# madeofcode for Herdr
+
+Theme snippets for [Herdr](https://herdr.dev), the terminal workspace manager
+for AI coding agents.
+
+Herdr themes aren't standalone files you drop into a themes directory — they're
+`config.toml` overrides. Each file here is a ready-to-paste block: a base
+theme name plus `[theme.custom]` color-token overrides derived from the
+[madeofcode Vim colorscheme](../vim/colors/madeofcode.vim).
+
+- `madeofcode.toml` — default
+- `madeofcode-protan.toml` — protanopia-safe variant
+- `madeofcode-tritan.toml` — tritanopia-safe variant
+
+## Install
+
+Herdr reads its config from:
+
+- macOS/Linux: `~/.config/herdr/config.toml`
+- Windows: `%APPDATA%\herdr\config.toml`
+
+### If you don't have a config.toml yet
+
+Append the file straight in:
+
+```sh
+mkdir -p ~/.config/herdr
+cat madeofcode.toml >> ~/.config/herdr/config.toml
+```
+
+### If you already have a config.toml
+
+Check first whether you already have `[theme]`, `[theme.custom]`, or `[ui]`
+tables — TOML doesn't merge duplicate table headers, so a second copy of the
+same header can clobber or conflict with the first, depending on the parser.
+
+```sh
+grep -nE "^\[theme|^\[ui\]" ~/.config/herdr/config.toml
+```
+
+- If none of those headers exist, it's safe to append the whole file as-is
+  (see above).
+- If `[theme]` / `[theme.custom]` already exist, replace their contents with
+  the ones from this file instead of appending a second copy.
+- If `[ui]` already exists, don't append a second `[ui]` header — merge the
+  `accent = "#6fd3ff"` line (or the protan/tritan equivalent) into your
+  existing `[ui]` table instead.
+
+### Apply it
+
+Validate the config, then reload without restarting panes:
+
+```sh
+herdr config check
+herdr server reload-config
+```
+
+Or choose **reload config** from Herdr's global menu.
+
+## Colorblind-safe variants
+
+Swap `madeofcode.toml` for `madeofcode-protan.toml` or
+`madeofcode-tritan.toml` in the steps above — same install process, different
+hue tokens. Grays (`panel_bg`, `surface*`, `overlay*`, `subtext0`, `text`) are
+identical across all three variants; only `accent`, `mauve`, `green`,
+`yellow`, `red`, `blue`, `teal`, and `peach` change.
+
+## Token mapping
+
+Herdr's `[theme.custom]` exposes 15 tokens on top of a built-in base theme
+(`catppuccin` here, since every token it defines is overridden anyway).
+Grays are pulled straight from the palette already documented in the
+[project README](../README.md#color-breakdown), ordered dark to light:
+
+| Herdr token | Hex | madeofcode role |
+|---|---|---|
+| `panel_bg` | `#090a1b` | Background |
+| `surface_dim` | `#12152e` | Background (raised) |
+| `surface0` | `#1c1e30` | Background (panel) |
+| `surface1` | `#363745` | Background (border) |
+| `overlay0` | `#353c4f` | NonText / SpecialKey |
+| `overlay1` | `#545454` | Special |
+| `subtext0` | `#81818a` | Gray / muted |
+| `text` | `#f8f8f8` | Foreground |
+| `accent` | `#6fd3ff` | Type / Function / Tag (cyan) |
+| `mauve` | `#c050c2` | Comment (magenta) |
+| `green` | `#8fff58` | String |
+| `yellow` | `#f1d950` | Yellow |
+| `red` | `#ff3854` | Keyword / Operator |
+| `blue` | `#0a9cff` | Constant / Number |
+| `teal` | `#00ffbc` | Constant identifier |
+| `peach` | `#cf6a4c` | Orange |
+
+`ui.accent` is set to the same hex as `theme.custom.accent` since Herdr uses
+it separately for highlights, borders, and navigation UI outside the theme
+token set.
diff --git a/herdr/madeofcode-protan.toml b/herdr/madeofcode-protan.toml
new file mode 100644
index 0000000..d4cb58d
--- /dev/null
+++ b/herdr/madeofcode-protan.toml
@@ -0,0 +1,29 @@
+# madeofcode-protan — theme snippet for Herdr (https://herdr.dev), colorblind-safe variant.
+# Derived from the madeofcode TextMate/Vim theme.
+# Install: append this block to ~/.config/herdr/config.toml (macOS/Linux)
+# or %APPDATA%\herdr\config.toml (Windows), then run
+# `herdr server reload-config` (or "reload config" from Herdr's global menu).
+
+[theme]
+name = "catppuccin"
+
+[theme.custom]
+panel_bg    = "#090a1b"
+surface_dim = "#12152e"
+surface0    = "#1c1e30"
+surface1    = "#363745"
+overlay0    = "#353c4f"
+overlay1    = "#545454"
+subtext0    = "#81818a"
+text        = "#f8f8f8"
+accent      = "#b9dcff"
+mauve       = "#7d84b8"
+green       = "#e8e6de"
+yellow      = "#b07400"
+red         = "#ffc21f"
+blue        = "#2f7bff"
+teal        = "#8fb4ff"
+peach       = "#a8863a"
+
+[ui]
+accent = "#b9dcff"
diff --git a/herdr/madeofcode-tritan.toml b/herdr/madeofcode-tritan.toml
new file mode 100644
index 0000000..9549476
--- /dev/null
+++ b/herdr/madeofcode-tritan.toml
@@ -0,0 +1,29 @@
+# madeofcode-tritan — theme snippet for Herdr (https://herdr.dev), colorblind-safe variant.
+# Derived from the madeofcode TextMate/Vim theme.
+# Install: append this block to ~/.config/herdr/config.toml (macOS/Linux)
+# or %APPDATA%\herdr\config.toml (Windows), then run
+# `herdr server reload-config` (or "reload config" from Herdr's global menu).
+
+[theme]
+name = "catppuccin"
+
+[theme.custom]
+panel_bg    = "#090a1b"
+surface_dim = "#12152e"
+surface0    = "#1c1e30"
+surface1    = "#363745"
+overlay0    = "#353c4f"
+overlay1    = "#545454"
+subtext0    = "#81818a"
+text        = "#f8f8f8"
+accent      = "#00d3a0"
+mauve       = "#c050c2"
+green       = "#4fd06a"
+yellow      = "#ff9d33"
+red         = "#ff3854"
+blue        = "#ff7ab0"
+teal        = "#c7f06a"
+peach       = "#cf6a4c"
+
+[ui]
+accent = "#00d3a0"
diff --git a/herdr/madeofcode.toml b/herdr/madeofcode.toml
new file mode 100644
index 0000000..6f0550f
--- /dev/null
+++ b/herdr/madeofcode.toml
@@ -0,0 +1,29 @@
+# madeofcode — theme snippet for Herdr (https://herdr.dev)
+# Derived from the madeofcode TextMate/Vim theme.
+# Install: append this block to ~/.config/herdr/config.toml (macOS/Linux)
+# or %APPDATA%\herdr\config.toml (Windows), then run
+# `herdr server reload-config` (or "reload config" from Herdr's global menu).
+
+[theme]
+name = "catppuccin"
+
+[theme.custom]
+panel_bg    = "#090a1b"
+surface_dim = "#12152e"
+surface0    = "#1c1e30"
+surface1    = "#363745"
+overlay0    = "#353c4f"
+overlay1    = "#545454"
+subtext0    = "#81818a"
+text        = "#f8f8f8"
+accent      = "#6fd3ff"
+mauve       = "#c050c2"
+green       = "#8fff58"
+yellow      = "#f1d950"
+red         = "#ff3854"
+blue        = "#0a9cff"
+teal        = "#00ffbc"
+peach       = "#cf6a4c"
+
+[ui]
+accent = "#6fd3ff"