The runtime your coding agents live on
Go to file
Michael Hackner eacea2daf0
fix: page keys scroll pane scrollback at zsh and REPL prompts (#2191)
* fix: page keys scroll pane scrollback at zsh and REPL prompts

PageUp/PageDown were forwarded to the pane whenever DECCKM (application
cursor) was on, assuming only primary-screen pagers enable it, but zsh's
line editor also enables DECCKM, as do REPLs such as python3. The result
was PageUp scrolling shell history instead of Herdr scrollback.

Bracketed paste discriminates the two: it means the app accepts typed or
pasted text at a prompt, so line editors enable it and pagers do not.

* test: update page key state fixture

---------

Co-authored-by: Can Celik <ogulcancelik@gmail.com>
2026-08-03 04:08:47 +03:00
.agents/skills fix(docs): publish only released documentation 2026-08-03 01:21:30 +03:00
.githooks fix: restore python3 commit hook 2026-07-29 01:29:14 +03:00
.github fix(docs): publish only released documentation 2026-08-03 01:21:30 +03:00
.pi fix: run pi worktree ext on background 2026-07-25 02:54:12 +03:00
.zed chore: enable zed lsp 2026-07-16 17:57:10 +03:00
assets docs: lean readme, add terminal trove gold sponsor 2026-07-08 02:47:47 +03:00
docs fix: propagate host color scheme to pane apps (#2214) 2026-08-03 02:05:27 +03:00
nix fix: scope agent skill installation 2026-07-29 21:21:22 +03:00
packaging/windows fix: bundle modern ConPTY on Windows (#1828) 2026-07-25 02:40:14 +03:00
scripts fix(docs): publish only released documentation 2026-08-03 01:21:30 +03:00
skills/herdr fix: scope agent skill installation 2026-07-29 21:21:22 +03:00
src fix: page keys scroll pane scrollback at zsh and REPL prompts (#2191) 2026-08-03 04:08:47 +03:00
tests fix(pi): restrict state reporting to tui sessions (#2159) 2026-08-03 03:44:44 +03:00
vendor chore: finish repository organization migration 2026-07-30 02:45:05 +03:00
website fix(docs): support older git in snapshot checks 2026-08-03 01:30:51 +03:00
workers/plugin-marketplace feat: add plugin marketplace blacklist 2026-06-22 01:26:20 +03:00
.gitattributes fix: bundle modern ConPTY on Windows (#1828) 2026-07-25 02:40:14 +03:00
.gitignore fix(docs): publish only released documentation 2026-08-03 01:21:30 +03:00
AGENTS.md fix(docs): publish only released documentation 2026-08-03 01:21:30 +03:00
CHANGELOG.md release: v0.7.5 2026-07-21 21:04:32 +03:00
CLAUDE.md chore: symlink CLAUDE.md to AGENTS.md 2026-06-10 20:26:01 +03:00
CONTRIBUTING.md fix(docs): publish only released documentation 2026-08-03 01:21:30 +03:00
Cargo.lock fix: preserve claude settings formatting (#2089) 2026-08-02 16:03:07 +03:00
Cargo.toml fix: preserve claude settings formatting (#2089) 2026-08-02 16:03:07 +03:00
LICENSE chore: relicense herdr under apache-2.0 2026-07-22 22:56:57 +03:00
README.md chore: finish repository organization migration 2026-07-30 02:45:05 +03:00
README.zh-CN.md chore: finish repository organization migration 2026-07-30 02:45:05 +03:00
SPONSORS.md docs: update sponsor acknowledgements 2026-07-28 00:59:17 +03:00
build.rs feat: add native windows beta support 2026-06-07 16:29:44 +03:00
clippy.toml
flake.lock ci: pin rust toolchain to 1.96.1 2026-07-09 22:43:25 +03:00
flake.nix fix(nix): add rust-analyzer to development shell 2026-07-25 22:28:54 +03:00
justfile fix(docs): publish only released documentation 2026-08-03 01:21:30 +03:00
rust-toolchain.toml ci: pin rust toolchain to 1.96.1 2026-07-09 22:43:25 +03:00

README.md

herdr

herdr

herdr.dev · install · quick start · docs · sponsors

English · 简体中文

Apache 2.0 license total GitHub release downloads GitHub stars latest stable release Homebrew version follow @herdrdev on X


https://github.com/user-attachments/assets/043ec09f-4bdd-41d5-aee0-8fda6b83e267

agent multiplexer that lives in your terminal.

  • every agent at a glance — blocked, working, done. real terminal views, not a wrapped interpretation.
  • detach, agents keep running — reattach from any terminal, or over ssh. sessions survive restarts.
  • agents can use herdr too — a pure socket api: agents spawn panes, read output, wait on each other. agent skill →
  • keyboard and mouse, both first-class — tmux-style prefix keys and click, drag, split. pick per moment, not per tool.
  • plugins — extend panes and workflows. browse the marketplace →
  • one rust binary, no electron — runs in whatever terminal you already use.

install

curl -fsSL https://herdr.dev/install.sh | sh

or brew install herdr · mise use -g herdr · windows beta: powershell -ExecutionPolicy Bypass -c "irm https://herdr.dev/install.ps1 | iex" · binaries

then start it where the work lives:

herdr

run your agents, split panes, walk away. ctrl+b q detaches, herdr reattaches. quick start →

docs

everything lives at herdr.dev/docs: quick start · concepts · supported agents · keyboard · configuration · session state · remote · integrations · plugins · socket api

sponsors

herdr is built full-time, in the open. sponsoring directly funds development, stability, and the path to a real agent runtime.

gold

Terminal Trove

→ become a sponsor · enterprise / partnership: hey@herdr.dev · see SPONSORS.md for tiers. thank you 🐑

agent instructions

if you are an ai agent helping with this repository, read AGENTS.md before making changes and read CONTRIBUTING.md before opening issues or PRs.

development

git clone https://github.com/herdrdev/herdr
cd herdr
cargo build --release

just test        # unit tests
just check       # formatting, tests, and maintenance checks

license

Herdr is licensed under the Apache License 2.0.