> ## Documentation Index
> Fetch the complete documentation index at: https://docs.happyuptime.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Install

One npm install. Two binary names — happy and happyuptime.

# Install the CLI

```bash
npm install -g happyuptime-cli
```

Two binaries — both work, pick whichever feels better:

```bash
happy --version
happyuptime --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
# or
happy --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 install
happy skill install --codex
happy 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.