herdr-portable — el mismo Herdr en cualquier máquina

Config, plugins fijados, fuente de iconos e integraciones. Un comando: ./install.sh.

PI no vive aquí. El agent portable es pi-portable.

Quick start

Linux (CachyOS / Kitty) y Windows (Alacritty → WSL):

curl -fsSL https://herdr.dev/install.sh | sh   # si herdr no está en PATH
git clone https://git.okvicio.club/vicio/herdr-portable.git
cd herdr-portable
./install.sh

En Windows el binario de Herdr (y PI) corre dentro de WSL. Alacritty es el terminal de Windows y pinta los glifos con DirectWrite: install.sh registra la TTF en Fontconfig de WSL y en las fuentes de Windows. Cierra Alacritty por completo y ábrelo otra vez, luego herdr.

Qué instala

• ~/.config/herdr/config.toml — tema one-dark, sidebar con logos / estado / usagebar, toasts, teclas
• ~/.config/herdr/agent-detection/*.toml — manifests de detección de estado por agent (overrides del autodetect, p. ej. el idle falso de Claude)
• 8 plugins desde GitHub, commit fijado (no se versionan los checkouts)
• Tabs: Auto Title (herdr.auto-title) gestiona los títulos (renombra la tab al directorio y/o título de conversación del agent). No convive con automatic-rename. Requiere Go 1.24+. Tras instalar, reinicia el server con herdr server stop y vuelve a lanzar herdr.
• Móvil: herdr-mobile-relay (Community WebRTC Gateway, sin Moshi ni Cloudflare)
• Integraciones: pi, omp, claude, codex (opencode y cursor si el binario está)
• Fuente Herdr Agent Icons Max (Fontconfig; en WSL también DirectWrite en Windows) + symbol_map en Kitty
• Nota en alacritty.toml si existe (WSL también mira el de Windows en %APPDATA%\alacritty)

No copia session.json, logs, ni plugins/github/ (rutas de máquina, cientos de MB).

Teclas extra (ctrl+b + la tecla):

Tecla	Qué abre
f / shift+f	file viewer (split / tab)
alt+r	reviewr
u	Agent Usage
alt+g	lazygit (popup)
y	yazi (popup)
a	agents: solo este space ↔ todos
m	mobile relay: setup / QR

Cómo funciona

install.sh es el camino repo → live. sync.sh es el camino inverso: copia el config.toml vivo y regenera config/plugin-manifest.tsv desde herdr plugin list --json.

live ~/.config/herdr          repo herdr-portable
config.toml                ↔  config/config.toml
herdr plugin list          →  config/plugin-manifest.tsv
plugins/github/*           (herdr lo clona al instalar)

Variaciones

• Alacritty: no toques font.normal. La TTF tiene que estar donde el proceso de Alacritty la vea (Windows Fonts si Alacritty es app de Windows). Reinicia el proceso, no solo la pestaña.
• Herdr nativo en Windows (sin WSL): .\install.ps1. No es el camino canónico: PI y Herdr van en WSL. Varios plugins son Linux/macOS y en nativo se saltan con WARN.
• Ghostty: el plugin icon-agent-ui pide font-family + font-codepoint-map en su README. El install no toca Ghostty.
• Actualizar plugins: cambia el commit en el manifest (o corre ./sync.sh) y re-ejecuta el install después de herdr plugin uninstall <id> si quieres forzar el ref. Si el plugin ya está, install lo salta.

Gotchas

• Los tokens $harness_logo, $state_*, $limit y $context no se ven sin las filas de [ui.sidebar.agents] en config.toml. El plugin puede estar instalado y el sidebar seguir vacío.
• Instalar la TTF solo en WSL no basta: Alacritty de Windows no usa Fontconfig de Linux. install.sh en WSL registra las dos.
• symbol_map, Fontconfig y DirectWrite no aplican a una ventana de Kitty/Alacritty ya abierta.
• Este repo no instala el binario de herdr ni nada de ~/.pi/agent.
• herdr.auto-title renombra la tab al título de conversación (con fallback al directorio). Requiere Go 1.24+ en el PATH del server herdr. Tras instalarlo, herdr server stop y vuelve a abrir herdr.
• PI a menudo no publica título OSC: esas tabs se quedan en pi hasta que haya conversación o hasta que mande el cwd.
• herdr-mobile-relay no necesita Caddy ni Moshi: elige Community WebRTC Gateway en el setup (prefix+m). El QR es secreto (lleva la clave). install.sh pone HERDR_MOBILE_RELAY_NO_AUTO_SETUP=1 para no abrir el menú en un install desatendido.