local-agent

name	local-agent
description	Build, install, select, and reload Happy Agent from this checkout, or switch back to the latest released Agent. Use when asked to link, relink, install, reload, or stop using a local Happy Agent build.

Local Happy Agent

Run checks before installation, then from the repository root run:

pnpm link:global

This builds the checkout, globally links Happy Terminal, installs and selects Agent version 0.0.0, and schedules a detached reload. The detached worker waits five seconds, allows graceful draining for 30 seconds, then falls back to kill followed by start.

Make pnpm link:global the turn's final tool call and return immediately after it. Do not poll the reload from the agent being reloaded. The worker logs to ~/.happy/agent/local-reload.log.

To bypass graceful drain when recovering a stuck daemon, run this as the final tool call:

node .agent/skills/local-agent/reload.mjs --hard

To switch back, use Happy Desktop's Agent version picker to download or select the latest release. No unlink script is needed.