r/herdr • u/WD40ContactCleaner • 7h ago
herdr-customize - an app mod: settings UI for themes, keybinds, mods, and core config across machines
I run herdr on a Windows desktop, a Linux box and a Mac, and customizing it meant editing keys.json, settings.json and herdr-core's config.toml on each machine over SSH. I kept forgetting which file held which setting, typo'ing keys, and ending up with machines that didn't match. The app version fixes that with a settings screen inside the app (Ctrl+Shift+Y).
What it does:
Theme picker with 100+ palettes and live preview
Keybind editor with conflict checks (no more hand-editing keys.json)
Browse and install mods and layouts from GitHub
Edit herdr-core settings (shell, scrollback, etc.) on this PC or your other machines from one page, plus one-click core updates. This works where the config is in its default location.
See which agents are installed on which machine, and rename or recolor them
Popups, e.g. lazygit or btop on a key
Nothing is written until you hit Save, and settings files get a daily backup, so it's safe to poke around. Written in Rust, runs on Windows, macOS and Linux.
Install (ask an agent inside the app):
Read ~/.config/herdr-app/AGENTS.md, then add this mod: github.com/wapenshaw/herdr-customize/tree/main/appRepo + screenshots: https://github.com/wapenshaw/herdr-customize
Bugs, missing settings and "why doesn't it do X" are all welcome. Tell me what you'd want in it.
TUI users: if anyone is still on the old version, please pin herdr-customize to v0.9.0
