The runtime your coding agents live on
Go to file
Ludovico Magnocavallo 679584fdd4
feat: add antigravity-cli integration (#2087)
* feat: add antigravity_cli integration harness

Register the `antigravity_cli` target, resolve its configuration
directory to `~/.gemini/antigravity-cli/`, wire target actions,
and add lifecycle hook scripts for Unix and Windows.

* feat: support session resume for antigravity-cli

* fix: correct antigravity-cli hook config path, shape, and agent label

Antigravity CLI reads global customizations from ~/.gemini/config, keys
hooks.json by hook name, and only accepts the matcher/hooks wrapper for
the tool events. The previous install wrote event arrays at the top level
of ~/.gemini/antigravity-cli/hooks.json, which agy never reads and would
reject anyway, so no Herdr hook ever ran.

Session reports were dropped for a third reason: the hooks reported the
agent as antigravity-cli, but the server normalizes that to the canonical
label agy before matching, so is_official_agent_source never matched and
agy --conversation resume was unreachable.

- Resolve the config dir to ~/.gemini/config
- Nest Herdr entries under a Herdr-owned "herdr" block that install
  rewrites and uninstall removes, leaving other named hooks untouched
- Emit grouped entries for PreToolUse/PostToolUse and flat handler lists
  for PreInvocation/PostInvocation/Stop
- Report the canonical agy label from both hook assets and match it in
  agent_resume
- Compile-gate the hook asset constants and stop shadowing $args in the
  PowerShell hook
- Document the real directory, that it must already exist, and the
  named-block behavior

refs #1011
refs #1571

* fix: make antigravity-cli integration session-only

antigravity cli cannot express lifecycle safely: there is no blocked
event, postinvocation is skipped on interruption, and stop fires at the
end of a turn rather than on process exit, which left stale state and
released authority at the wrong time.

report only the conversation on preinvocation and let screen detection
own agent state. resume via `agy --conversation <id>` is unchanged.

* fix: update antigravity session after conversation switch

---------

Co-authored-by: Can Celik <ogulcancelik@gmail.com>
2026-08-01 19:32:47 +03:00
.agents/skills chore: consolidate project skills 2026-07-25 21:04:01 +03:00
.githooks fix: restore python3 commit hook 2026-07-29 01:29:14 +03:00
.github fix(ci): skip pr gate in forks 2026-08-01 18:21:42 +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 feat: add antigravity-cli integration (#2087) 2026-08-01 19:32:47 +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(input): preserve native key lifecycle across routing (#2142) 2026-08-01 04:27:50 +03:00
skills/herdr fix: scope agent skill installation 2026-07-29 21:21:22 +03:00
src feat: add antigravity-cli integration (#2087) 2026-08-01 19:32:47 +03:00
tests fix: report a clear cli error when no herdr server is running (#1963) 2026-08-01 16:17:23 +03:00
vendor chore: finish repository organization migration 2026-07-30 02:45:05 +03:00
website chore: update repository links after organization transfer 2026-07-29 23:29:29 +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 feat(docs): publish versioned release documentation 2026-07-22 14:59:09 +03:00
AGENTS.md chore: update agentmd for protocol changes 2026-07-31 16:28:15 +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 ci: remove approved contributor bypass 2026-07-29 02:54:53 +03:00
Cargo.lock fix: preserve windows sessions after ssh logout (#2098) 2026-07-30 23:39:03 +03:00
Cargo.toml fix(client): restore terminal on sighup and sigterm 2026-07-31 00:46:01 +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 chore: enable clippy linting 2026-05-09 23:16:24 +03:00
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 docs: add simplified chinese readme (#1990) 2026-07-29 02:18: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.