onboarding: add Herdr as a supported multiplexer#54
Merged
Conversation
There was a problem hiding this comment.
Pull request overview
This PR updates the onboarding runbook to support Herdr as an alternative (or complement) to tmux for keeping long-running agent sessions alive, and adds a shared Herdr config template plus corresponding maintenance/architecture notes.
Changes:
- Renames ONBOARDING step 7 to cover “Terminal multiplexer — tmux and/or Herdr” and adds Herdr installation/integration usage notes.
- Adds a new shared
onboarding/dotfiles/herdr-config.tomlwith recommended Herdr defaults. - Updates MAINTAINING to reflect “tmux or Herdr” and documents the new dotfile in the artifact map and decision rationale.
Reviewed changes
Copilot reviewed 3 out of 3 changed files in this pull request and generated 5 comments.
| File | Description |
|---|---|
| onboarding/ONBOARDING.md | Adds Herdr as a supported multiplexer option in step 7, including install/integration instructions and remote-attach aliases. |
| onboarding/MAINTAINING.md | Updates the architecture model and artifacts/decisions to include Herdr alongside tmux. |
| onboarding/dotfiles/herdr-config.toml | New shared Herdr configuration template for onboarding members who use Herdr. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
Comment on lines
+19
to
+21
| # Preserve pane screen contents across a full server restart, so a long run's | ||
| # output isn't lost if the server bounces. | ||
| pane_history = true |
Members can now set up Herdr (mouse-first, agent-state-aware multiplexer) as an alternative or complement to tmux, mirroring the PI's setup. - ONBOARDING step 7 renamed to cover both multiplexers: adds Herdr install (herdr.dev), `herdr integration install claude` (auto-wires the agent-state hook into the member's own settings.json), the config template copy, and optional olt/olh remote-attach aliases. - New onboarding/dotfiles/herdr-config.toml: group Herdr config (priority agent sort, terminal-routed toasts, pane history, larger scrollback), genericized from the PI's ~/.config/herdr/config.toml. - MAINTAINING: architecture note (tmux or Herdr), artifact-map row, and two Decisions & rationale entries (multiplexer choice; why the herdr hook is installer-generated rather than a copied settings.json). No step renumbering and CLAUDE.global.md untouched, to stay off a collision course with the in-flight cc-watchdog branch, which edits those. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
Lets new members set up Herdr (a mouse-first, agent-state-aware terminal multiplexer) as an alternative or complement to tmux — mirroring the PI's setup so they can "mimic me".
Changes
herdr.dev/install.sh),herdr integration install claude(auto-wires the agent-state hook into the member's own~/.claude/settings.json), config-template copy, launch/detach basics, and optionalolt/olhremote-attach aliases.onboarding/dotfiles/herdr-config.toml— group Herdr config (priority agent sort, terminal-routed toasts, pane history, larger scrollback), genericized from the PI's~/.config/herdr/config.toml.Scope / conflict-avoidance
No step renumbering and
CLAUDE.global.mdleft untouched, deliberately, to stay off a collision course with the in-flightcc-watchdogbranch (which editsONBOARDING.mdstep 13 andCLAUDE.global.md). This PR only renames step 7 and adds a dotfile, so it should merge cleanly alongside it.Claims kept honest: members get cc-watchdog (step 13) as their stall-guard, which is herdr-aware; the PI's auto-handoff/Phoenix watchers remain deferred (per MAINTAINING) and are noted as multiplexer-aware only if enabled later.
🤖 Generated with Claude Code