Windows

El soporte nativo de Windows está disponible de forma general.

Herdr en Windows usa ConPTY y el comportamiento de procesos y runtime de Windows en lugar del modelo de PTY de Unix sobre el que Herdr se construyó originalmente. La mayoría de los flujos de trabajo básicos están cubiertos, pero algunas capacidades difieren de Linux y macOS o dependen de la plataforma. Windows puede recibir más correcciones específicas a medida que se cierren esos huecos.

Instala Herdr en Windows con PowerShell:

powershell -ExecutionPolicy Bypass -c "irm https://herdr.dev/install.ps1 | iex"

Si la seguridad del equipo bloquea ese comando de PowerShell sin fichero, abre el símbolo del sistema y ejecuta:

curl.exe -fsSLo install.cmd https://herdr.dev/install.cmd && install.cmd && del install.cmd

Las compilaciones de Windows están disponibles en los canales de actualización estable y preliminar. Las instalaciones nuevas usan el estable por defecto, que es el recomendado para el uso normal. Las instalaciones preliminares existentes siguen en preview hasta que ejecutes herdr channel set stable. Si una compilación preliminar antigua rechaza ese comando, ejecuta herdr update una vez en preview y reintenta. El canal preliminar ofrece correcciones más nuevas y menos probadas desde master, y puede fallar; pásate con herdr channel set preview solo si quieres ese compromiso.

El instalador guarda las versiones en %USERPROFILE%\.herdr\packages\standalone\releases, pone en el PATH el directorio de la versión activa, mantiene %LOCALAPPDATA%\Programs\Herdr\bin como alias estable de compatibilidad y conserva unas pocas versiones antiguas para que los procesos en marcha no bloqueen las actualizaciones.

Para pruebas internas, HERDR_MANIFEST_URL puede apuntar el instalador a un manifiesto propio en lugar del manifiesto estable o preliminar de Herdr. Define HERDR_CHANNEL=preview con un manifiesto preliminar propio.

Compatible en Windows

Capacidad	Estado
Sesiones persistentes locales	compatible
Paneles nativos mediante ConPTY	compatible
Conexión desde Windows Terminal o la aplicación de PowerShell	compatible
herdr --remote y máquinas SSH guardadas hacia hosts Linux, macOS y Windows	compatible; la conexión interactiva y la configuración de máquinas guardadas pueden instalar o actualizar paquetes de Windows tras confirmar; la reconexión en segundo plano solo detecta paquetes instalados
Imágenes del portapapeles remoto y arrastre de ficheros de imagen	compatible
Paneles con cmd.exe	compatible
Entrada nativa de teclado y ratón	compatible
Directorio inicial y etiquetas de espacio de trabajo	compatible
Directorio de lanzamiento de los paneles	compatible
Descubrimiento de comandos de agente	compatible
Integraciones de informe propio de los agentes compatibles	compatible
Detección de agentes por árbol de procesos	compatible
Detección de Git y worktrees desde un directorio conocido	compatible
Notificaciones del sistema y sonidos MP3	compatible
Plugins	preliminar
Historial de pantalla de los paneles	compatible
Anulación del lanzamiento anidado	compatible

Las sesiones persistentes locales siguen en marcha después de que el cliente se desconecte o se cierre su ventana de terminal. Los servidores y los procesos de panel lanzados a través del OpenSSH de Windows también sobreviven al cierre de sesión; ejecuta herdr de nuevo para volver a conectarte.

La detección de procesos de agente en Windows explora los descendientes del shell del panel y reconoce los agentes directos y los envoltorios de comando habituales, incluidas las cadenas de procesos de npm/Node y Git Bash. Sigue a los agentes lanzados desde Git Bash a través de los límites de exec emulados, pero no es lo mismo que la detección por grupo de procesos en primer plano de Unix.

La instalación de integraciones en Windows admite por ahora Pi, OMP, Claude Code, Codex, GitHub Copilot CLI, Devin CLI, OpenCode, Kilo Code CLI, Droid, Kimi Code CLI, Qoder CLI y Antigravity CLI. La disponibilidad es menor que en Unix; Herdr oculta o rechaza las integraciones cuyo formato de instalación no está admitido en Windows.

Los plugins admiten windows como plataforma de manifiesto de forma preliminar. La instalación desde GitHub, el enlace local, los comandos de construcción, las acciones, los eventos y los paneles de plugin son de mejor esfuerzo en Windows. Los comandos son argv y deben ser compatibles con Windows; los envoltorios de paquetes de Node, como npm, bun y node, deberían funcionar cuando están en el PATH, mientras que los ejemplos solo para Unix con sh o Bash necesitan alternativas específicas de Windows. Los filtros de plataforma se saltan los comandos de construcción no admitidos y devuelven platform_unsupported en las acciones o paneles no admitidos.

Soporte parcial

Capacidad	Estado
Directorio en vivo tras un cd en el shell	parcial
Directorio en vivo mediante integración del shell u OSC7	compatible
Pegado de imágenes del portapapeles a agentes en paneles locales	depende de la terminal y del agente
Anclaje de la composición de IME CJK	parcial
Cambio de fuente de entrada en el prefijo (IME coreano)	parcial
Pintado de gráficos Kitty	depende de la terminal
Pintado del cursor de la terminal	parcial

Herdr puede lanzar los paneles en el directorio correcto y crear el espacio de trabajo inicial desde el directorio en el que arrancaste Herdr. Después del arranque, el campo de proceso que Herdr puede inspeccionar no sigue de forma fiable los cd lógicos posteriores en PowerShell. Usa las integraciones de Herdr o la integración del prompt del shell para informar del directorio en vivo.

Durante herdr --remote, la tecla configurada para pegar imágenes en remoto lee una imagen del portapapeles de Windows y la transfiere al host remoto. Soltar un fichero de imagen local en Windows Terminal también transfiere ese fichero y pega su ruta remota.

El cambio de fuente de entrada en el prefijo está disponible como experimento opcional para el IME coreano. Cambia la entrada Hangul a inglés mientras los comandos de prefijo están activos y restaura después el modo anterior:

[experimental]
switch_ascii_input_source_in_prefix = true

Los demás IME de Windows aún no están admitidos por esta opción. Mira Configuración.

Algunos agentes de Windows pueden recibir ctrl+v y leer imágenes del portapapeles directamente. El lector de imágenes del portapapeles de Herdr no está conectado a los paneles nativos locales de Windows, así que el pegado de imágenes nativo de los agentes sigue dependiendo de la terminal y del agente. Los atajos de pegado de imágenes de los agentes, como alt+v, no añaden un puente de portapapeles local gestionado por Herdr. El puente de imágenes del portapapeles remoto está admitido aparte a través de herdr --remote hacia hosts Linux, macOS y Windows.

Los gráficos Kitty están activados por defecto y dependen de la terminal exterior. Herdr emite la salida del protocolo de gráficos Kitty en Windows como en las demás plataformas. Esta vía se ha probado con WezTerm en Windows alojando Herdr a través de WSL, pero no están verificadas todas las combinaciones de terminal nativa de Windows y ConPTY. Windows Terminal no expone la vía de gráficos Kitty que usa Herdr. Pon [terminal].kitty_graphics = false si la terminal exterior maneja mal la salida gráfica.

Salvedades conocidas

Pintado del cursor

Herdr depende de ConPTY para los paneles nativos de Windows. La vía del cursor de la terminal de Windows puede exponer posiciones intermedias mientras un multiplexor repinta la pantalla. Un cursor nativo puede parpadear, saltar o quedarse brevemente en una posición antigua durante la salida activa. Este comportamiento se reproduce también en otros multiplexores nativos de Windows y con pruebas de estrés directas de posición del cursor VT, así que Herdr no puede eliminarlo sin renunciar al comportamiento nativo del cursor.

Para priorizar la estabilidad visual, el valor por defecto host_cursor = "auto" pinta el cursor de Herdr como contenido de celda en Windows nativo y en WSL. Los demás clientes de Linux y macOS siguen usando el cursor nativo de la terminal. El cursor pintado de Windows es fijo y no parpadea, pero no ofrece el parpadeo, la forma ni el color del cursor nativo de la terminal exterior.

Windows no usa un cursor pintado para colocar la interfaz de composición y candidatos del IME. Por eso la interfaz de los IME coreano, japonés o chino puede aparecer en el sitio equivocado. Si te afecta, vuelve al cursor de la terminal exterior:

[ui]
host_cursor = "native"

El modo nativo recupera el anclaje del IME, pero puede reintroducir parpadeos, saltos o posiciones atrasadas del cursor durante la salida activa.

Teclado y ratón

No todas las terminales de Windows informan de las teclas con modificador de la misma forma. Herdr conserva los informes de ratón y ctrl+j en Windows Terminal y en Alacritty en Windows. La vía de entrada nativa de Windows también conserva las pulsaciones físicas, las repeticiones, las liberaciones, Escape suelto y shift+enter en los paneles ConPTY por defecto. Las teclas con modificador siguen dependiendo de que la terminal exterior informe de un evento de tecla distinto; si informa de shift+enter como un Intro normal, Herdr solo puede reenviar un Intro normal.

Los paquetes de Windows incluyen el runtime ConPTY local actual de Microsoft, porque el ConPTY del sistema en compilaciones antiguas de Windows 10 descarta las secuencias del protocolo de teclado de Kitty que usan agentes como Kimi y Pi. Define HERDR_WINDOWS_CONPTY=system antes de arrancar Herdr solo cuando estés diagnosticando un problema de compatibilidad con el runtime incluido.

Copiar y pegar

Copiar texto de un panel funciona en Windows. Selecciona con arrastre dentro de un panel para copiar a través de Herdr.

Para pegar texto, usa ctrl+shift+v en Windows Terminal. El pegado de varias líneas va entre corchetes, para que los shells y los prompts de los agentes lo reciban como un único pegado en vez de enviar cada línea por separado. Mantén shift y haz clic derecho para usar la acción de pegar de la terminal exterior en lugar de enviar el clic a Herdr.

No compatible en Windows

Capacidad	Estado
Conexión directa a una terminal (herdr terminal attach)	no compatible
Traspaso en caliente del servidor	no compatible
Traspaso de descriptores de fichero de Unix	no compatible
Grupos de procesos en primer plano de Unix	no compatible
Puente de imágenes del portapapeles de Herdr en paneles nativos locales	no compatible
Binario firmado / evitar SmartScreen	no compatible

Desde Windows Terminal, usa el mismo comando remoto que en Linux y macOS:

herdr --remote workbox

El host de destino puede ser Linux, macOS o Windows. En hosts Windows, la conexión remota reutiliza un paquete compatible del PATH o de la versión gestionada activa. La conexión directa interactiva y la configuración de máquinas guardadas preguntan antes de instalar o actualizar el paquete completo cuando hace falta. La reconexión de máquinas guardadas en segundo plano solo detecta paquetes instalados y no puede pedir instalaciones ni actualizaciones. Herdr usa el cliente OpenSSH instalado en Windows y tu configuración de SSH. El OpenSSH de Windows no usa la reutilización por socket de control de Unix de Herdr, así que se recomienda la autenticación por clave a través del ssh-agent de Windows para evitar preguntas repetidas durante la configuración remota.

Las actualizaciones en Windows pasan por el instalador de Windows y actualizan la ruta de la versión activa. Las terminales nuevas y las sesiones SSH reconectadas reciben esa ruta; arranca Herdr ahí para usar el cliente actualizado. Los servidores compatibles en marcha conservan sus paneles. Reinicia un servidor más tarde solo cuando necesites cambios del lado del servidor de esa versión. El traspaso en caliente es solo para Unix.

Informar de problemas en Windows

Incluye:

• Versión de Herdr.
• Versión de Windows.
• Aplicación de terminal.
• Shell, como PowerShell o cmd.
• Si usaste una HERDR_SESSION con nombre.
• Los registros de Herdr relevantes.
• Los pasos exactos para reproducirlo.