Instalar harnsy

Una frase a tu agente o un solo comando. El instalador se queda en tu cuenta de usuario y pregunta antes de cambiar los ajustes de otra herramienta.

Deja que tu agente lo instale.

Pega esto en Claude Code, Codex u OpenCode. El agente primero te muestra el plan, luego instala y después te pide que respondas a las preguntas del instalador en tu propia terminal. Tus archivos de ajustes no los edita él.

Para instalarlo basta una frase a tu agente.

Instala harnsy siguiendo https://harnsy.dev/llms.txt

O ejecuta un solo comando.

La misma instalación, sin agente. Descarga la versión demo desde GitHub (harnesy/app).

Linux y macOS
curl -fsSL https://harnsy.dev/install.sh | sh
Windows (PowerShell)
irm https://harnsy.dev/install.ps1 | iex
Linux y macOS: mostrar cada paso sin cambiar nada
curl -fsSL https://harnsy.dev/install.sh | sh -s -- --dry-run
Windows: mostrar cada paso sin cambiar nada
$env:HARNSY_INSTALL_ARGS = "--dry-run"; irm https://harnsy.dev/install.ps1 | iex

Versión demo: 1 proyecto, hasta 10 agentes funcionando a la vez, sin nodos ni modo clúster.

Linux, Windows y macOS (aún sin verificar en un Mac real).

Qué hace el instalador

Todo lo que escribe, todo lo que pregunta y lo que deja como está. harnsy install --dry-run imprime cada paso, el diff de cada archivo que cambiaría y la ruta de cada archivo que crearía, y no cambia nada.

Se queda en tu cuenta de usuario.

Todo va a tus propias carpetas de usuario. Sin sudo ni permisos de administrador. No cambia el PATH ni el perfil de tu shell; si ~/.local/bin no está en el PATH, te lo dice.

Comprueba la descarga.

El instalador de un solo comando descarga desde GitHub por HTTPS la versión para tu sistema y tu CPU, y se detiene si el archivo no aparece en el SHA256SUMS de la versión o no coincide. Lo descomprime en una carpeta temporal, ejecuta harnsy install desde ahí y borra la carpeta al terminar. La comprobación detecta una descarga dañada o cortada; las sumas vienen de la misma versión.

Instala tres cosas sin preguntar.

El programa, un registro de instalación y un servicio en segundo plano solo para tu usuario. El servicio arranca ya y en cada inicio de sesión.

Lo que se escribe sin preguntar en una instalación nueva
	Linux	macOS	Windows
El programa (una copia)	`~/.local/bin/harnsy` y el enlace `~/.local/bin/ccbus`	como en Linux	`%LOCALAPPDATA%\harnsy\bin\harnsy.exe`
Registro de instalación	`~/.local/share/harnsy/install.json` y `hooks/harnsy-introduce.py`	como en Linux	`%LOCALAPPDATA%\harnsy\install.json`
Un servicio: arranca ya y al iniciar sesión, se reinicia tras un fallo	unidad de usuario de systemd `~/.config/systemd/user/harnsy.service`	LaunchAgent `~/Library/LaunchAgents/com.github.butschster.harnsy.plist`, registro en `~/Library/Logs/harnsy/`	tarea `harnsy` del Programador de tareas, con privilegios mínimos; si Windows la rechaza, el valor `harnsy` en `HKCU\Software\Microsoft\Windows\CurrentVersion\Run` (sin reinicio tras un fallo)

Si ya hay otro archivo de servicio u otra tarea, te lo muestra y lo reemplaza solo después de tu sí. Un archivo ~/.local/bin/ccbus existente se mueve a ccbus.pre-harnsy.

Todo lo demás lo pregunta antes.

Cada punto es una pregunta [y/N]. Solo cuenta y o yes; sin respuesta, sin terminal o con --dry-run, la respuesta es no.

Qué terminal abre a tus agentes, mientras no haya uno elegido: WezTerm o tmux (tmux no en Windows); se guarda como terminal.driver en ~/.harnsy/config.yaml.
El icono de la bandeja (Linux, macOS): ~/.local/bin/harnsy-tray. Arrancarlo al iniciar sesión es una segunda pregunta.
Un hook de inicio para las sesiones nuevas en ~/.claude/settings.json y ~/.codex/hooks.json, solo si existe ~/.claude o ~/.codex (no en Windows).
Una línea de estado en ~/.claude/settings.json, solo si no tienes ninguna.

Para cada archivo de ajustes te muestra primero el cambio exacto. Un archivo que ya existe se copia antes a ~/.local/share/harnsy/backups/ (Windows: %LOCALAPPDATA%\harnsy\backups\). Ninguna opción responde sí por ti; --no-tray, --no-hooks y --no-statusline omiten un paso.

Se queda en tu máquina.

El panel en 127.0.0.1:7788 y el puerto de agentes en 127.0.0.1:7790 solo escuchan en este ordenador. El servicio también recibe 127.0.0.1:7789 para otros nodos; ese puerto solo se abre después de que emitas un token de nodo, y nunca en la demo. harnsy no envía telemetría ni busca actualizaciones: habla con tus harness en esta máquina y con los nodos que conectes.

No toca:

los servidores MCP: imprime la línea opcional claude mcp add para que la ejecutes tú
~/.claude.json
el ~/.codex/config.toml de Codex
los ajustes de OpenCode

Más adelante, mientras funciona: solo con claude.auto_trust: true en config.yaml (desactivado por defecto) harnsy marca como de confianza la carpeta de un proyecto en ~/.claude.json antes de abrir Claude Code en ella, después de copiar el archivo a claude.json.bak en ~/.harnsy. Codex abierto por harnsy recibe la confianza en la carpeta como opciones de línea de comandos; no se escribe ningún archivo.

Cómo quitarlo.

harnsy uninstall quita el servicio, la bandeja, el programa y las entradas que añadió a tus ajustes, y pregunta antes de cada cambio en los ajustes. Tus datos en ~/.harnsy y las copias de seguridad se quedan hasta que los borres. harnsy uninstall --dry-run te lo muestra todo antes.