Herdr
Running Luxe inside an agent multiplexer.
Herdr is a terminal multiplexer for coding agents: it keeps each agent in a
persistent pane and rolls their state — working / blocked / idle / done — up into a sidebar,
so you can run several agents across projects at once and jump to whichever one needs you.
Luxe is Herdr-aware out of the box. When it detects it is running inside a Herdr pane
(HERDR_ENV=1), it reports its own lifecycle to Herdr over the local socket (herdr pane report-agent) as a custom integration — no Herdr update, manifest, or herdr integration install
step required, because Herdr does not need to recognize the luxe process at all. The sidebar then
tracks Luxe accurately: working while a turn runs, blocked whenever it needs you — a
question or a tool-permission approval — and idle/done when the turn ends. Reporting is best-effort and silent — if Herdr is absent or a
call fails, nothing breaks — and every report carries a monotonic sequence so out-of-order delivery
can’t reorder state. Opt out with LUXE_HERDR=0.
curl -fsSL https://herdr.dev/install.sh | sh # install Herdr (Linux/macOS)
herdr # launch/attach the multiplexer
# then, inside a pane:
luxe
To let Luxe drive Herdr (split panes, spawn sibling agents, wait on their state) when you ask it
to, add Herdr’s own skill — Luxe discovers SKILL.md files from ~/.config/luxe/skills/ (global)
and .luxe/skills/ (project):
mkdir -p ~/.config/luxe/skills/herdr
curl -fsSL https://raw.githubusercontent.com/ogulcancelik/herdr/master/SKILL.md \
-o ~/.config/luxe/skills/herdr/SKILL.md