Mods and layouts for Herdr, the desktop app for terminals and coding agents.
| Item | What it does |
|---|---|
| aifbr | Layout: muted sage-and-stone palette (light & dark), aifbr sidebar header, IBM Plex typography, framed terminal cards with always-on headers, and a tab bar that shows buttons for every panel in its stack. |
| github-panel | Open PRs and issues of the space's repo, via gh. cmd-shift-g opens it. Start any installed agent on an issue, with model and reasoning, in a new worktree. A status-bar CI badge, with a notification when any space's checks finish. |
| servers-panel | CPU, memory, disk and Docker containers of every machine Herdr reaches. Logs, restart, and a notification when a container goes down. cmd-shift-m opens it. |
| ideas-panel | An ideas bank in a Markdown file you choose (an Obsidian vault works): capture with #tags, filter by repo or tag, tick off, turn into a GitHub issue. cmd-shift-i opens it. |
Popup (cmd-shift-g) |
Side panel (cloned layout) |
|---|---|
![]() |
![]() |
| Servers | Ideas | AIFBR layout |
|---|---|---|
![]() |
![]() |
![]() |
Ask your agent to add herdr.dev/layouts/obrunogonzaga/herdr-mods--aifbr (for the layout) or github.com/obrunogonzaga/herdr-mods/github-panel (for a panel), or copy it yourself:
Layout:
git clone https://github.com/obrunogonzaga/herdr-mods
cp -R herdr-mods/aifbr/mods/aifbr-chrome herdr-mods/aifbr/mods/aifbr-tabs ~/.config/herdr-app/mods/
cp herdr-mods/aifbr/layouts/aifbr.json ~/.config/herdr-app/layouts/
cp herdr-mods/aifbr/themes/*.json ~/.config/herdr-app/themes/
herdr-app check ~/.config/herdr-app/mods/aifbr-chrome
herdr-app check ~/.config/herdr-app/mods/aifbr-tabsGitHub panel:
cp -R herdr-mods/github-panel/mods/github herdr-mods/github-panel/mods/issue-agent ~/.config/herdr-app/mods/
herdr-app check ~/.config/herdr-app/mods/github
herdr-app check ~/.config/herdr-app/mods/issue-agentServers: cp -R herdr-mods/servers-panel/mods/servers ~/.config/herdr-app/mods/.
Ideas: cp -R herdr-mods/ideas-panel/mods/ideas ~/.config/herdr-app/mods/, then point it at your file in ~/.config/herdr-app/ideas.json: { "file": "~/notes/ideas.md" } (default ~/ideas.md).
Then merge each item's keys.json into ~/.config/herdr-app/keys.json.
Mods are trusted code: the panel mods run gh, git, open and docker (on every machine Herdr reaches), restart containers and start agents. Read them before installing.
Edit here, then run ./sync.sh. Tests: node --test. It copies every item's mods/, layouts/ and themes/ into ~/.config/herdr-app (or $HERDR_APP_HOME) and runs herdr-app check on each mod. Herdr reloads on copy.
Herdr doesn't follow symlinks for live reload, so the repo is copied, not linked.
personal/ is my machine-local setup (keys, settings, program table, and my-layout.json wiring the extra panels onto the aifbr layout). It has no RECIPE.md, so it isn't listed on herdr.dev.




