Skip to content

Use terminal-safe Herdr direct shortcuts - #157

Merged
BrettKinny merged 6 commits into
mainfrom
agent/herdr-keyboard-shortcuts
Aug 13, 2026
Merged

Use terminal-safe Herdr direct shortcuts#157
BrettKinny merged 6 commits into
mainfrom
agent/herdr-keyboard-shortcuts

Conversation

@BrettKinny

@BrettKinny BrettKinny commented Aug 13, 2026

Copy link
Copy Markdown
Collaborator

Summary

  • Resolve the branch against the current main.
  • Use terminal-safe Ctrl+Alt direct chords for Herdr letter actions:
    • Ctrl+Alt+N — new workspace
    • Ctrl+Alt+Q — detach
    • Ctrl+Alt+Z — zoom
    • Ctrl+Alt+\\ — horizontal split
  • Keep the F12 prefix fallbacks and preserve existing user-owned Herdr configs.
  • Add a provisioning regression assertion and document the terminal encoding rationale.

Why

Many terminals collapse Ctrl+Shift+letter into the unshifted control key, so
the previously generated Ctrl+Shift+N binding was not reliably delivered to
Herdr. Ctrl+Alt is distinguishable across the supported terminal paths;
F12, then Shift+N, remains available as the compatibility fallback.

Checks

  • bash -n on changed shell scripts
  • bash tests/test-provision-state.sh — 31/31 passing
  • git diff --check
  • GitHub repository-tests — passing

The Docker build checks are still queued on GitHub.

BrettKinny and others added 4 commits July 20, 2026 11:06
on_force_close "quit" killed the whole session (and every process in
it) whenever the ssh/mosh chain dropped — the opposite of what a
multiplexer is for. Default to "detach" and self-heal existing
configs on upgraded containers, mirroring the tmux mouse self-heal.

Also bind <leader> ? to a floating configuration plugin as a
keybinding help popup (clear-defaults=true leaves no discoverable
help otherwise).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Ctrl+Space is transmitted as a NUL byte that some client stacks never
deliver (iPadOS grabs it for input-source switching before Blink sees
it). Mirror every Ctrl+Space mode bind with Ctrl+b — the classic tmux
prefix — in the shipped config and the self-heal. Scroll/search modes
keep their explicit Ctrl+b page-up binds, which take precedence over
the shared exit bind.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@BrettKinny BrettKinny changed the title Add Herdr keyboard shortcuts Use terminal-safe Herdr direct shortcuts Aug 13, 2026
@BrettKinny
BrettKinny marked this pull request as ready for review August 13, 2026 22:29
@BrettKinny
BrettKinny merged commit 2217c87 into main Aug 13, 2026
4 checks passed
@BrettKinny
BrettKinny deleted the agent/herdr-keyboard-shortcuts branch August 13, 2026 22:29
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant