herdr — Agent Guide

No conflict-matrix pairs for this tool yet.

# Herdr — Agent Guide

name: herdr ｜ version_range: 0.8.2~0.8.2 ｜ generated: 2026-08-28

title_en: Herdr - Terminal Runtime for Coding Agents ｜ desc_en: Persistent sessions, workspace/worktree management, agent panel and integrations.

Preflight

note: Linux x86_64; no runtime dependencies.

uname -m

预期输出: see command output

Install

note: gh-proxy acceleration recommended in mainland China. Method A verified in this environment; Method B (official install script) not tested.

Method A: release binary

note: Verified in this environment.

curl -sL -o herdr https://gh-proxy.com/https://github.com/herdrdev/herdr/releases/download/v0.8.2/herdr-linux-x86_64
chmod +x herdr
./herdr --version

预期输出: herdr 0.8.2

Method B: official install script

note: Provided by herdr.dev; not tested in this environment.

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

预期输出: herdr installed to ~/.local/bin or /usr/local/bin

Operations

View command surface

note: Verified in this environment.

herdr --help

预期输出: session/workspace/worktree/tab/notification/agent/pane/integration/server/config/channel/api 等子命令

Status check

note: Verified in this environment; does not start the server.

herdr status

预期输出: client version 0.8.2 + channel stable + server status (socket path shown when not running)

Config validation

note: Verified in this environment; passes without config.toml (default config used).

herdr config check

预期输出: config: ok (passes without config.toml — first run uses default config)

Start/attach a persistent session

note: Starts the background server; server may stay resident after exiting the session.

herdr --session main

预期输出: enters persistent session terminal surface (first run creates ~/.config/herdr/ + ~/.local/state/herdr/agent-detection/; server may stay resident after exiting session)

Stop the background server

herdr server stop

预期输出: server stopped (via socket API)

Uninstall

note: Single binary removal (per actual install path); dedicated directories auto-removed; stop a running server first.

herdr server stop 2>/dev/null || true
rm -f /usr/local/bin/herdr ~/.local/bin/herdr
rm -rf ~/.config/herdr ~/.local/state/herdr
command -v herdr >/dev/null 2>&1 && echo '残留: herdr 仍存在' || echo 'herdr removed: OK'

预期输出: herdr removed: OK

Facts

writes: ~/.config/herdr, ~/.local/state/herdr ｜ runtime: Linux x86_64, single binary ｜ notes: background server started with --session (socket + logs + session files); stop with herdr server stop

Source: herdr · validated 2026-08-28 · v0.8.2~0.8.2

← Agent index