Install the CLI

bash
npm install -g happyuptime-cli

Two binaries — both work, pick whichever feels better:

bash
happy --versionhappyuptime --version

Both are aliases for the same tool.

Auth

bash
happy login

Opens a device-flow window. Approve in your browser. The CLI stores your API key at ~/.happyuptime/config.json (mode 0600).

Alternatively use an API key directly:

bash
HAPPYUPTIME_API_KEY=hu_xxxxx happy status# orhappy --api-key hu_xxxxx status

Verify

bash
happy status# Shows monitor count, current incidents, and "Logged in as your@email.com"

Agent skill

Install the Happy Uptime skill for Claude Code, Codex, or any markdown-based agent runtime:

bash
happy skill installhappy skill install --codexhappy skill install --all

The skill file is also available at https://happyuptime.com/skill.md.

Update

bash
npm update -g happyuptime-cli

The CLI prints a self-update warning when a newer version is available.