herdr-muse

Muse Code integration for Herdr — makes muse (muse-spark, muse-bin-*) appear as a first-class Herdr agent (muse) without rebuilding Herdr.

Herdr is a terminal workspace manager for AI coding agents. It tracks panes, tabs, and agent lifecycle (idle / working / blocked) and shows them in its sidebar. Out of the box Herdr knows claude, codex, cursor, copilot, amp, pi, etc. — this plugin adds muse (Meta Muse Code).

Demo

Before:

herdr pane list --workspace w2
  w2:p7  agent=-  status=unknown  title=cliprelay   # muse running but Herdr says unknown

After (muse in w2:p7):

herdr pane list --workspace w2
  w2:p7  agent=muse  status=working  title=cliprelay

herdr agent list
  w2:p7  muse  working  ~/.local/share/muse/sessions/.../session.jsonl

Empty fish tabs stay unknown — no false positives.

Installation

1. Clone & link as Herdr plugin

git clone https://github.com/reduced2ash/herdr-muse.git
cd herdr-muse
./install.sh

install.sh does two things:

1. Patches ~/.local/bin/muse (the launcher that execs muse-bin-*) to report to Herdr on every launch when inside Herdr (HERDR_ENV=1). It backs up the original to ~/.local/bin/muse.bak.<ts> and is idempotent. The patch is ~30 lines and fire-and-forgets over HERDR_SOCKET_PATH (500 ms timeout, never blocks startup). On exit (trap EXIT HUP INT TERM) it clears the pane label so you don't get stuck muse ghosts.
2. Links the Herdr plugin: herdr plugin link /path/to/herdr-muse && herdr server reload-config.

2. Verify

herdr agent list          # should show muse in current pane as working
herdr pane list --workspace w2

# New empty tab should stay clean:
herdr tab create --workspace w2   # or Ctrl+T / new tab in UI
herdr pane list --workspace w2   # new pane: agent=- status=unknown

# Manual re-report if needed (e.g., after a server restart):
herdr plugin action invoke herdr-muse report-muse
# or directly:
HERDR_PANE_ID=w2:p7 bash ~/.config/herdr/plugins/local/herdr-muse/report.sh

# Clear a stuck label:
herdr plugin action invoke herdr-muse clear-muse

3. Alternative Herdr-native install (once