Skip to content

About

Mods for Herdr, the desktop app for terminals and coding agents

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

herdr-mods

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)
GitHub popup GitHub side panel
Servers Ideas AIFBR layout
Servers Ideas AIFBR

Install

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-tabs

GitHub 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-agent

Servers: 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.

Development

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.

About

Mods for Herdr, the desktop app for terminals and coding agents

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages